add-docs-site

You can add a static documentation site to a Rails application by scaffolding an Astro Starlight site that builds directly into the public/docs directory, allowing Thruster or ActionDispatch to serve it without altering Rails routing.

Yes, Astro Starlight integrates with a Rails Docker build process by adding specific build steps for the documentation site alongside bun-managed dependency installation, ensuring the static HTML is generated during the Docker image creation.

The best way to include Mermaid diagrams in Astro Starlight docs is to use the astro-mermaid integration, which is automatically configured during the scaffolding process to render diagrams within your documentation content.

No, you do not need to change Rails routes to serve Astro documentation because the build outputs static HTML to public/docs, allowing existing Rails static file serving mechanisms to handle requests directly.

The Astro Starlight dev server works with Rails Procfile.dev by adding a dedicated entry that runs the local development server, enabling live previews of documentation changes alongside your Rails application.

You can automate publishing Astro Starlight documentation by using a generated GitHub Actions CI workflow that builds the static site and deploys the output, triggered automatically by repository commits.