Site: https://developer.aiven.io/ Repo: https://github.com/aiven/devportal
Reading list:
- Sphinx homepage https://www.sphinx-doc.org/en/master/
- Furo theme https://github.com/pradyunsg/furo
- Vale https://github.com/errata-ai/vale and its GitHub Action https://github.com/errata-ai/vale-action
- External TOC plugin https://github.com/executablebooks/sphinx-external-toc
- Netlify and Sphinx tutorial https://hangar.tech/posts/deploying-sphinx-to-netlify/
- Netlify deploy previews https://docs.netlify.com/site-deploys/deploy-previews/
- Diataxis https://diataxis.fr/
- Plugins https://jareddillard.com/blog/common-ways-to-customize-sphinx-themes.html (a good number of my favourites were made by Jared, thanks!)
- https://github.com/mgaitan/sphinxcontrib-mermaid Mermaid