Skip to content

Consumer documentation deployment

This project owns the Markdown below docs/ and the static documentation image it publishes. The released builder image supplies the shared theme, navigation, search, Markdown extensions, and strict validation.

docs/ -- DOCS_TOOLKIT_IMAGE --> site/ -- DOCS_IMAGE --> deployed documentation

Image ownership

harbor.norrsign.se/norrsign/docs-toolkit:v1 is the released builder. This project pulls it, then publishes only its own DOCS_IMAGE. The builder does not publish a :latest tag. This project's runtime releases use matching semantic, major, and immutable commit tags; it does not publish :latest either.

Local authoring uses .env and npm. Production Compose uses the separate .env.compose with one docs runtime service in compose.production.yaml; it pulls the published runtime image and does not build documentation.

Start here