usrse / usrse23 Goto Github PK

The current Dockerfile fails to build. Update the Dockerfile and related files to enable reproducible builds of the website and support local container-based development workflows conducive to code collaboration.

I cloned the repo and could not find instructions for how to build or develop the site locally, so I naively tried a docker build that failed on line 4 of the Dockerfile because there is no Gemfile.lock file. Also there is obviously a missing line that copies in the source files. Can someone explain how to build and run the site locally? I'd be happy to contribute this documentation once I demonstrate the workflow to do so.

We want to build the hype and make a countdown timer!

cc @sandragesing

After noticing a broken internal link in one of the pages I've written (#9) I've also looked into a few ways to reduce the chance of this happening in the future:

A) https://github.com/benbalter/jekyll-relative-links: a Jekyll extension that allows using relative paths to Markdown files as a way to specify internal links (i.e. the way it works on GitHub)
B) Add a CI check for broken links, e.g. https://github.com/gjtorikian/html-proofer, using GitHub Actions

Disclaimer:

• I don't have much experience with Jekyll (these are just things I've found during a 10-minute search), so I definitely don't have strong preferences or opinions on how to go about
• If you (and the technical/website folks in particular @mrmundt @cabejackson in particular) think this could be useful, I'd be happy to try and throw together a quick GitHub Actions workflow to run the linkchecker for PRs

I've noticed that the link on the https://us-rse.org/usrse23/participate/ page pointing to the Notebook Submissions page (https://us-rse.org/usrse23/notebook-submissions) is broken.

I'm opening a PR to fix the specific issue, but in the meantime I've also looked into a few ways to reduce the chance of this happening in the future (#10).