usrse / usrse23 Goto Github PK

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

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'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).

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