OpenRath Documentation

The repository keeps its version-matched Sphinx source and now also contains a Next.js frontend. The Next app reads the existing Markdown source at build time, renders it through React, and leaves the multi-version builder available for historical snapshots.

Next.js workflow

Install packages with npm install, run npm run dev for a local preview, and use npm run lint plus npm run build before publishing. The app code lives in app/, reusable rendering code in components/ and lib/, and the documentation source of record remains under source/.

This repository publishes version-matched documentation for OpenRath. The main branch tracks the current stable documentation, while annotated tags pair each documentation snapshot with the same tag in the sibling OpenRath repository.

flowchart LR
  D["OpenRath-Docs vX.Y.Z"] --> B["local version builder"]
  C["OpenRath vX.Y.Z"] --> B
  B --> S["one switchable site"]

Loading

Version policy

• main: current stable docs (v1.3.0 at this update).
• v1.0.0 through v1.3.0: immutable local documentation snapshots paired with matching OpenRath code tags.
• archive/pre-versioning-2026-07-11: the pre-versioning documentation state.

No permanent future-version or maintenance branch is required for the current workflow. Start one only when real concurrent work makes it necessary.

Local preview

Install the documentation dependencies in the sibling code repository once:

cd ../OpenRath
uv sync --group docs
cd ../OpenRath-Docs

Build all six versions and start a local server:

make versions
make serve

Open http://localhost:8000/. The root redirects to stable/ (v1.3.0), and the navigation switcher can move between every tagged version.

Useful commands:

make html                         # strict current-version build
make versions                     # build all tagged versions
make versions VERSIONS="v1.2.2 v1.3.0"
make list-versions
make clean

See versioning/README.md for builder details. Generated HTML lives under _build/ and is not committed.