mkdocs-rc-docs
mkdocs-rc-docs copied to clipboard
UCL-RITS
Experimental Research Computing documentation generation using mkdocs
To do: - [x] Link to our two Moodle courses on our front page - [ ] Link to relevant video sections from the Intro to HPC course using the...
At the moment we have a lot in our top-level navigation that ended up there by default and wasn't thought about whether that was the appropriate place to put it...
Logging into UCL HPC systems is repeated in two different locations: - [Remote access page](https://www.rc.ucl.ac.uk/docs/Remote_Access/): - [HowTo page](https://www.rc.ucl.ac.uk/docs/howto/)
The https://www.rc.ucl.ac.uk/docs/Contact_Us/ page states that: >The Research Computing Team are located at: >> 105 Judd Street Floor 1 London WC1E 9RN This appears to be out of date. I am...
Even though some of the colours across the site don't fail accessibility review, they may not be sufficiently contrasting for good readability. This is an issue for taking a general...
While looking at the code snippet colours, @dstansby posted [this link to an accessibility analysis tool](https://wave.webaim.org/report#/https://www.rc.ucl.ac.uk/docs/Example_Jobscripts/#serial-job-script-example) which suggested that the contrast on the navigation links may be too low. Worth...
The copyright years for the docs page currently says `2014 - 2020`, which is out of date. Considering the ongoing/continuous maintenance burden to keep updating the copyright year, I wonder...
From #8 Currently only exists at the bottom of https://github.com/UCL-RITS/rcps-buildscripts/issues/205
On https://www.rc.ucl.ac.uk/docs/Wiki_Export/X-Forwarding/#checking-your-setup there's a suggestion to use `glxgears` to check that X-forwarding is working. `glxgears` doesn't work for me on a macOS host: ``` $ glxgears libGL error: No matching...
mkdocs for material comes with a new copy code button that makes it easy to copy code such as those given in the example job scripts page [here](https://www.rc.ucl.ac.uk/docs/Example_Jobscripts/). Achieving this...