Docs and website

Informative guide. This Book page explains Beskid but does not define the standard. For normative requirements, use the Beskid Standard.

Public docs live in site/website. Two reader areas only:

• Platform specification — normative
• Beskid Book — informative tutorial (this file tree)

Use pnpm for local workflows:

cd site/website
pnpm dev
pnpm test:docs-links
pnpm build

Book navigation comes from book/nav.order.json through generate:book-nav-tree. Standard navigation comes from root openspec/catalog.json; the website does not own normative content.

Book vs spec

If two reviewers would argue about observable behavior, the change belongs in OpenSpec first. The Book explains how to apply the rule. Use Documentation authoring for the current checks.