Restructure recommendations and update CI
- test the full docs build in CI
- strict build
mkdocs build -sto catch broken links - fixing a load of broken links
- restructuring the recommendations section
work towards #28
Edited by Samuel Van Stroud
mkdocs build -s to catch broken linkswork towards #28