Foundations

Sample: Authoring chapters

Second sample chapter covering frontmatter, ordering, and local files.

Sample

Sample. Replace the sample chapter files in src/content/knowledge/ with real course pages.

Create a chapter file

Add an MDX file under src/content/knowledge/. Required frontmatter:

title: "Sample: Authoring chapters"
description: Short summary for lists and search.
section: Foundations
sectionOrder: 1
order: 2
sample: true

Ordering rules

  1. Sort by sectionOrder
  2. Then by order inside the section
  3. Titles break remaining ties

Reading aids

Chapter pages expose:

  • breadcrumbs back to the handbook home and section
  • a sidebar of all chapters
  • an on-this-page table of contents for headings
  • previous and next links in reading order

Replace the samples

Delete every knowledge file with sample: true, then add your own chapters. Keep the same frontmatter shape so navigation stays automatic.