Describe what should be investigated or refactored
We have had issues with Docusaurus and would like to explore other options for hosting a documentation site. This should explore:
- If we can modify Docusaurus to fit our needs better
- If another solution better meets our needs
This should not lose the following:
- Search - including good index and offline support
- Support for custom MDX syntax (notes and admonitions)
- Configurability/themability
This will also need an ADR comparing different options and explaining why we went a particular direction.
Links to any relevant code
https://github.com/defenseunicorns/zarf/tree/main/docs-website
Additional context
This comes out of us looking at our docs and thinking about how we could incorporate them into Zarf to bring it along to the airgap.
Describe what should be investigated or refactored
We have had issues with Docusaurus and would like to explore other options for hosting a documentation site. This should explore:
This should not lose the following:
This will also need an ADR comparing different options and explaining why we went a particular direction.
Links to any relevant code
https://github.com/defenseunicorns/zarf/tree/main/docs-website
Additional context
This comes out of us looking at our docs and thinking about how we could incorporate them into Zarf to bring it along to the airgap.