Welcome to the Nais documentation

See the Nais handbook for a more detailed explanation of the documentation structure and how to contribute.

Tools for working with tenants

Warning about features not available in test-nais

If a page should have a warning about not being available in test-nais, add the following near the top of the page:

<<not_in_test_nais("Name of feature")>>

Exclude a full page from one or more tenants documentation

Add the following to the frontmatter of the page:

conditional: [not-test-nais, not-nav]

Include a page only for one or more tenants

Add the following to the frontmatter of the page:

conditional: [tenant, nav, ssb]
              ^^^^^^--- the keyword "tenant" is required to exclude all not mentioned

Copilot Agents

Four agents handle documentation tasks:

@research-agent → @technical-writer → @plain-language-en → @docs-qa

• @research-agent — Investigates Nais source repos via GitHub MCP. Read-only.
• @technical-writer — Writes/edits docs following repo conventions (Diataxis, mkdocs, Jinja macros).
• @plain-language-en — Copy-edits for plain language, removes AI jargon.
• @docs-qa — Verifies docs accuracy against Nais source code. Read-only.

Start with @research-agent to gather context, hand off to @technical-writer to draft, which auto-hands off to @plain-language-en for polish. Then hand off to @docs-qa to verify accuracy against source code. Use @docs-qa standalone to audit any existing page.

Local development

1. Install Poetry

asdf plugin add poetry
asdf install poetry latest

2. Install dependencies

make install

3. Serve the documentation locally

make local

3a. Serve a tenant-specific version of the documentation

TENANT=nav make local

3b. Do a clean build of the documentation

make clean-build