Docs and website

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

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

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

Use Bun for local workflows:

cd site/website
bun run dev
bun run test:docs-links
bun run build

Book nav comes from book/nav.order.json → generate:book-nav-tree. Platform-spec navigation comes directly from root openspec/catalog.json; the website does not generate or own normative content.

Book vs spec

If two reviewers would argue about observable behavior, the argument belongs in platform-spec first. The book explains how to apply the rule—chapter 12 exists because we learned this the hard way.