Arcjet’s Post

This is how we used Astro's Starlight framework to build our documentation with support for framework switching, a custom sidebar, and a custom table of contents for improved SEO and a better user experience. Documentation is the product and we spend a lot of time on it! We initially started with Nextra, a docs framework for Next.js, however, we found it to be too inflexible and difficult to customize. After some evaluation, we turned to Starlight: a needs-no-presentation, content-driven Astro docs framework. This has been a very flexible choice with virtually no friction in adoption, serving us well until recently. However, as our SDK started to add support for different frameworks, developing its functionality and increasing features, we realized that the docs structure was becoming defective and painful to work with. Read more on our blog (link in comments)!

To view or add a comment, sign in

Explore topics