Skip to content

Contributing

Canonical prose lives under docs/; website/ projects it into the documentation site. Start with CONTRIBUTING.md for issue linkage and the pull-request checklist.

Edit the canonical Markdown linked by a page's source attribution. Language or API changes also require reviewing implementation evidence and updating the relevant specification and coverage mappings.

Follow AGENTS.md and the development policy, including the local validation pause. Documentation changes do not authorize compiler changes, fixture or expected-byte updates, frozen-template changes, or weakened tests. Investigate prose/implementation mismatches at their source.

Check built pages, links, navigation, and search in light and dark themes and at narrow widths. Keep generated projections, dependencies, build output, and reports out of Git. Reviewed snapshots under docs/_generated/ are maintained inputs.

Pull requests run documentation checks without publishing. Deployment instructions define manual releases from main, matching native-release verification, and recovery.


Canonical source: docs/contributing/index.md.