Every change lands through a pull request — nothing goes directly to main. See the
Contribution Workflow
for the full process: draft first, the Copilot review loop, then human review.
-
Branch, then edit the relevant page(s) under
src/docs/. -
If you added or renamed a page, run the index generator:
pwsh .github/scripts/Update-DocumentationIndex.ps1
-
Validate links locally before opening a pull request:
pwsh .github/scripts/Test-DocumentationLink.ps1
-
Preview the site if you want to see the rendered result:
pip install -r requirements.txt cd src zensical serve -
Open the pull request as a draft and follow the Contribution Workflow.
See the README for what this repository is and how it builds, and the Ways of Working for the conventions every pull request follows — issue format, PR format, branching, and review etiquette.