Talking and Doc'ing, 12 June 2025

Join Astro Docs maintainers as we work on the docs! We could be triaging issues, merging PRs, writing recipes, working on Starlight... something different every week! PRs reviewed on stream: (Don't forget to jump in, leave a comment, and get credit towards your Astro Badge: https://astro.badg.es/contributors/ ) - A new feature added to the Adapter API to allow adapters to receive `Headers` from prerendered pages: https://github.com/withastro/astro/pull/13926/files - Astro Docs upgrade to the latest version of Starlight, which includes an update to cascade layers and the new `routeData` feature: https://github.com/withastro/docs/pull/11870 - Experimental Live Content Collections - first peek at new upcoming docs for this not-yet-released feature: https://github.com/withastro/docs/pull/11782 Other discussions: - writing good error messages (always include what someone should *do* when they encounter the error!) - the history of Astro Docs features: build for Docs, add to Starlight, re-integrate the Starlight feature back into docs - custom Astro Docs components / "unique" Astro Docs pages e.g. Astro Docs Tutorial - when you introduce a new kind of thing, like "Live Content Collections", you also need a name for the existing, unnamed kind! (And it's not "regular collections"!) - Docs smell: similar content in too many places so that you can't easily tell someone which section to go to. This probably means you need to reorganize and consolidate! ("If you go to Error handling... no, the other error handling...")