#Starlight
6 posts
Build a Manual with Starlight #6: Maintenance — Search, Accessibility, Docs Culture
The final post in the series. We touch on Starlight's built-in search, accessibility that lets everyone read the docs, and the Docs as Code culture that keeps docs alive for the long run, closing the series on the operations perspective.
Build a Manual with Starlight #5: Multilingual and Versioning
We cover serving one doc in multiple languages and keeping old docs around as product versions move up. Multilingual support comes built into Starlight, and versioning is added with a plugin.
Build a Manual with Starlight #4: Deploy to Cloudflare Pages and Connect a Domain
We send the docs we built locally out into the world. We push to GitHub, connect Cloudflare Pages and set up the Astro build, and attach a custom domain.
Build a Manual with Starlight #3: Writing Content — Code Blocks, Mermaid, asides
We cover three elements that make docs pleasant to read: code blocks that carry titles and line highlights, Mermaid diagrams added via a plugin, and asides that show cautions and warnings. We go over how to use each in Starlight.
Build a Manual with Starlight #2: Sidebar and Search — Structuring Your Docs
When your docs grow to dozens of pages, the sidebar and search are key to keeping readers from getting lost. We configure the sidebar automatically and manually in Starlight, and take a look at the built-in search.
Build a Manual with Starlight #1: From Install to Your First Doc
We set up the skeleton of a team documentation and product manual site with Astro's Starlight, walking through everything from getting Node.js ready to creating a site with create astro and bringing up your first doc on the dev server.