Contributing to juneau-docs

Sidebar label convention

Every sidebar label: must equal the page title: frontmatter value, without a number. sidebars.ts generates the numbers from position (the numbered() helper), so never type one into a label.

Example: title: "YAML Basics" in file 02.34.01.YamlBasics.md → sidebar label: 'YAML Basics', displayed with its generated position number in front of it. The file prefix and the displayed number are independent.

Exception: the four Getting Started pages carry their number in the page title (title: "1. Install Juneau"), so their label is the title minus that prefix.

A divider heading inside a section (for example Core Concepts) is wrapped in group({...}): it has no number and its children continue the parent's count.

If a title is too long for comfortable sidebar display, shorten the page title — don't curate a separate sidebar label. This keeps the two in sync automatically.