Quality
4 pages filed under Decisions › quality. A decision is a choice made for the project, with its context, its options and what it affects.
| Decision | Date | First line | Links |
|---|---|---|---|
| Reproducible builds | 2026-09-13 | Two builds of the same sources write the same bytes. Every list is sorted canonically before it is written, findings by check, source, path, line and message, entities by identifier, links by their triple, provenances by method, path and line; a step that runs in parallel sorts its results before writing them; nothing random is ever written, and the only timestamp is the at field of the build log, also the at of the build block of the model, pinned by SOURCE_DATE_EPOCH following the reproducible-builds convention. A double-build test and a continuous-integration step compare every file of two builds of the golden corpus, so that a published site can be diffed against the previous one. | 25 |
| Findings, not failures | 2026-09-12 | A content anomaly becomes a finding, never a crash. The build fails only when the configuration says so. Every check is a pure function in a registry shared by the build and the linter, and a test enforces their parity. | 13 |
| Core, plugins, preset | 2026-09-12 | The core reads markdown and produces JSON and depends on no office format nor system tool. Readers, converters, importers, viewers and heavy projections are plugins declared in the configuration. The unscoped concordance package is the preset that enables all of them. | 12 |
| GPL-3.0-or-later | 2026-09-12 | Every package of the tool is published under the GNU General Public License, version 3 or later, and a licence inventory of the dependencies is regenerated and verified before every release; a dependency whose licence is outside the allow-list fails the check, and widening the list is a decision of the maintainers. The wiki a project generates with the tool is the project's own: the licence covers the tool, not what it documents. | 7 |
4 quality of 4 — pagination by twenty. The Links column counts the related pages, which brings the most central quality of the journey to the top.