Decisions
27 decisions described. A decision is a choice made for the project, with its context, its options and what it affects.
| Decision | Date | First line | Links |
|---|---|---|---|
| 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 |
| No database | 2026-09-13 | The graph is built in memory and serialised to model.json, canonically sorted and validated by a published schema; concordance render reads it without touching the sources, and a Cypher export is provided for those who want the graph elsewhere. No server, no database and no state between two builds other than the pipeline cache: the model is a file that a pipeline writes, commits, diffs and serves. | 11 |
| Keyword page threshold | 2026-09-12 | A keyword page exists from three occurrences in at least two files; below that, the word is searchable but has no page. The threshold is configurable, and the build reports how many pages it generated and how many expressions it discarded. | 10 |
| Static first | 2026-09-12 | The build is a pipeline command that produces a static site. The main content of every page is in the served HTML, the site works over file://, and fragments load on demand from JSON files. An optional service will consume the same model later; nothing in the site depends on it. | 10 |
| Confidence and provenance on every link | 2026-09-12 | Every link carries a confidence between 0 and 1 and at least one provenance. When methods agree, confidences combine and every provenance is kept. The first version stores the score, orders mentions with it, and does not show it. | 9 |
| Standard markdown only | 2026-09-12 | Concordance reads CommonMark, GFM and optional YAML frontmatter, nothing else. No wikilink, no proprietary tag, no directive: every file stays readable without the tool, and structured information goes through frontmatter, headings and lists. | 9 |
| 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 |
7 decisions of 27 — pagination by twenty. The Links column counts the related pages, which brings the most central decisions of the journey to the top.