Browse documentation

Start here

OverviewYour first siteBuild and inspect your siteWrite useful documentationGlossaryTroubleshooting

Shape your site

ConfigurationAuthoring recipesSections and identityCustomize the home pageThemesCustom CSS (advanced)Machine-readable contractsVisual fixturesMathematics

Publish safely

Audit your documentationGitHub PagesPre-publish checklistHistorical documentationQualification evidenceMigration

Pascal and project internals

PasWeave integrationArchitectureArchitecture analysisProject specification (historical)

Project decisions

BoundariesHistory and customisationRelease-tag publicationReader-first documentationLocal syntax highlightingExisting-repository adoptionGitHub Pages setupDocumentation auditSimple configurationv1.0 stable contractDocSprout rebrand

ADR 0004: Keep the beginner path reader-first

User-facing guides lead with a goal, prerequisites, copyable steps, expected results and recovery guidance. The shortest local-preview path stays separate from optional release machinery, unavoidable terms are defined, and general documentation advice works beyond Pascal while Pascal remains the primary example. Technical reference and project internals remain available after the learning path instead of interrupting it.