Release note
The sample app is now the documentation site
The repository’s sample site now serves as the framework documentation site and exercises the public API directly.
Highlights
- The site is now organized around tutorials, cookbooks, reference, explanation, blog, and release notes.
- The documentation content lives under content/ and is rendered by the same framework it documents.
- The site crate was refactored into smaller route modules to keep the application code legible.
Documentation is now a dogfooding app
The repository no longer treats the sample site as a disposable demo. It is now the documentation site for the framework itself.
That change matters for two reasons:
the examples are no longer toy-only
the docs exercise the public API continuously
What changed
The site now uses collection-backed content for:
tutorials
cookbooks
reference
explanation
blog
release notes
The navigation and homepage are organized around Diátaxis so readers can choose the lens that matches what they need.
Why make this change
When the docs are just prose in docs/, they can drift away from the actual framework usage.
When the docs are rendered by the framework:
examples stay closer to real call sites
route generation gets exercised more deeply
content and assets are tested by normal usage
design mistakes become visible earlier