Our docs are now built with Starlight instead of Docusaurus
a year ago
- #documentation
- #static-site-generator
- #developer-tools
- Glasskube switched from Docusaurus to Starlight for building Distr's documentation.
- Starlight is built on Astro, offering better developer experience, faster build times, and easier customization with Tailwind.
- Docusaurus relies on React and Infima, making updates slower and customization harder.
- Both frameworks support SEO features, but Starlight's integrations are more streamlined.
- Starlight lacks built-in support for marketing pages and Mermaid diagrams, unlike Docusaurus.
- Technical documentation should be clear, concise, and structured to guide users from concepts to practical use cases.
- Visual aids like diagrams and screenshots enhance understanding in technical docs.
- Glasskube is happy with the switch to Starlight despite some limitations.