Remix.run Logo
trcarney 17 hours ago

Something we are working on my team is an internal Astro Starlight site. It is all in markdown so if your team is backend focused, the can still maintain it, and then all the docs are markdown files that are tracked with git. Comes with basic search already built in too.

So far we like the idea of this approach but haven't fully set it up yet

coronapl 6 hours ago | parent [-]

We recently added an Astro Starlight site to our monorepo, and it’s been great. Whenever someone makes a significant change, the PR includes the corresponding docs update, which makes reviews much more complete.

Another benefit: since the docs live in the repo, they’re easy to feed into AI tools.You just drop the relevant Markdown files in as context. This workflow has worked really well for us.

The only real headache was adding auth to our Wiki, but we eventually found a simple solution.