Artifact cbe40bd3994298c3e9824826d6278196b41f2dc06ded0b8a6a8dcf5fe16d9dbc:
- File
docs/site/content/docs/reference/conformance.md
— part of check-in
[41dfd5c149]
at
2026-10-23 21:12:44
on branch main
— docs: landing page from the approved design, docs in its typography
The home page renders its hero figure, conformance table, version and footer from the generated data and site params. Docs pages keep Hextra with Fraunces, Inter and JetBrains Mono and rust as the accent in both themes. Add the get-started pages (install, CLI quickstart, embed in Go, first sync), the conformance reference rendered from data, and point the nav, README and old links at the new layout. (user: [email protected], size: 1592) [annotate] [blame] [check-ins using] [more...]
--- title: Conformance weight: 40 layout: conformance description: Every requirement of every draft go-libfossil implements, with its status, from the conformance test suite. --- go-libfossil is checked against the Internet-Drafts that specify Fossil's formats and protocol, and the drafts for the extensions it shares with zit. The drafts are pinned in [`conformance/rfcs/`](https://github.com/danmestas/go-libfossil/tree/main/conformance/rfcs). Each has a table of requirements in [`conformance/requirements/`](https://github.com/danmestas/go-libfossil/tree/main/conformance/requirements), written from the draft text, and test cases that name the requirement they exercise. `TestCoverage` derives each requirement's status from its cases; nothing is recorded by hand: - **covered**: every case conforms. - **partial**: the cases conform, and the table row says what they leave out (shown under the requirement). - **deviation**: a case documents a deliberate difference, with its reason. - **failing**: a case is known to fail and names the issue tracking the fix. It is skipped, and fails once it passes until the mark is removed. - **gap**: no case exercises the requirement. What counts as correct, in order: the draft text; then fossil itself, run on the same input, where the draft is silent. The suites of zit and libfossil inform which cases to write. The tables below are generated from a run of the suite (`make docs-gen`), and CI fails when they are out of date. To reproduce them: ```sh CONFORMANCE_REPORT=report.md go test ./conformance -run '^TestCoverage$' -count=1 ```