Migrate devtools projects from sphinx to mkdocs and a single site
ssbarnea opened this issue · comments
As part of migrating towards pure markdown and simple documentation building, we will gradually replace sphinx with mkdocs, especially as this is the only option that also allows us to keep using the http://readthedocs.org/ service.
- create devtools consolidated site
- integrate als into devtools site
- migrate als
- migrate compat
- migrate linter
- migrate navigator
- migrate molecule
- migrate molecule plugins
Challenges and blockers
- mkdocs monorepo plugin from backstage not supporting includes backstage/mkdocs-monorepo-plugin#92
- mkdocstrings/python#49
- pdm-project/pdm#1510