Source for:
- https://odra.dev
- https://odra.dev/blog
- https://odra.dev/docs
- https://odra.dev/llms.txt — generated documentation index for LLM agents
The code is automatically published after push to the master branch.
$ just install
$ just develop
just docs-new-version version
This repo holds the documentation only. The code it documents lives elsewhere:
- odradev/odra — the framework itself, plus the project
templates that
cargo odra newgenerates from - odradev/cargo-odra — the
cargo odraproject generator and build tool (cargo install cargo-odra --locked) - odradev/odradev-plugins — Claude Code plugin with skills for agentic Odra development
When a change lands in any of them, check whether getting-started/installation and the intro still describe the setup correctly — those two pages are what users and AI agents read first.
Note that docs are versioned: an edit to docusaurus/docs/ usually needs the same edit in
docusaurus/versioned_docs/version-<latest>/ to reach readers of the current release or release of the new version of the docs.
A snapshot covers a minor line, not a patch release - version-2.9 is labelled 2.9.* on the
site and serves everyone on 2.9.x. Patch-level fixes are copied into the existing snapshot; only a
new minor gets just docs-new-version <x.y>. Name snapshots 2.9, never 2.9.* - the directory
name would then contain *, which is an illegal filename character on Windows and would make the
repository impossible to check out there.
Adding, renaming or removing a page changes static/llms.txt, which is regenerated on every build
and is what AI agents read. The Claude Code plugin keeps an annotated copy at
plugins/odra-plugin/reference/docs-map.md in
odradev/odradev-plugins — update it in the same batch
so agents do not chase URLs that no longer exist.
You can reach us at contact@odra.dev.