wardley-maps.sgit.ai / The documents
The documents
The research this site was built from, published in full. Ten documents, 17,321 words, plus a 73-row source manifest. The raw markdown in /briefs/ is the source of truth — the reader pages render those same files rather than copying them, so the two cannot drift.
Publishing the brief alongside the site is not generosity, it is the same discipline as shipping a map's source next to its render and naming the artefact behind every doctrine rating. It also lets you catch us: in two places the research disagrees with the artefacts it describes, this site publishes the artefacts' numbers, and you can now check which is right — N1 and N2.
| Document | What it does | Words | Raw |
|---|---|---|---|
| The brief pack, read me first | What the commission was, what each document does, and the four things that will bite you — the licence collision first among them. | 1,090 | 00__README.md |
| The brief | The commission, two corrections to its premise, the thesis, the five pages only this site can write, the honesty constraint, and the build order. | 2,086 | 00__BRIEF.md |
| The concepts index | Every distinct idea in the corpus with the words it was first stated in, its date and its classification. The source this site's glossary and concepts endpoint are parsed from — and the header whose counts do not match its own table. | 2,838 | 01__concepts-index.md |
| Explorer / Villager / Town Planner | The raw material for the pattern write-up: what is on disk, which roles sit where, and the finding that 31 of 33 role definitions never mention Wardley. | 1,675 | 02__pioneers-settlers-town-planners.md |
| Job A — the published record | Twenty-six items over seven years, the four claims held throughout, the two silences, and the archive priority order for the fragile ones. | 1,561 | 03__job-a__dinis-published-material.md |
| Job B — the industry resources | The angle that makes a curation page worth writing, the per-resource template, the ranked top ten, the licence minefield and the three start-here routes. | 1,833 | 04__job-b__industry-resources.md |
| Maps and rendering | What maps exist, the coordinate contract proven by rendering rather than repeated, the complete wardley-beta parse rule, and the pipeline as something runnable. | 1,490 | 05__maps-and-rendering.md |
| Site architecture | The house pattern, the six markers, page-by-page IA, and what moves here versus what gets referenced. | 1,168 | 06__site-architecture.md |
| Boundaries and licensing | The CC BY / CC BY-SA collision in full, the do-not-publish list, screenshot ethics and house style. | 1,289 | 07__boundaries-and-licensing.md |
| Gaps and open questions | Seven things that had to be written fresh, eight artefacts commissioned and never made, eight open questions and seven honest tensions. | 1,386 | 08__gaps-and-open-questions.md |
| The pack's licence | CC BY 4.0, and the four regimes it does not cover. | 905 | LICENSE.md |
| The source manifest | 73 rows. Every source, tiered 0–3, with its proposed page and whether it is publishable. Served as CSV — there is no reader page, because a spreadsheet is not prose. | — | 09__source-manifest.csv |
And the data
Three of these documents ship structured data alongside the prose. It is served as-is:
/data/industry-resources.json— 34 resources and 11 dead entries, each with licence and a pre-written attribution string. The pages built from it →/data/dinis-published.json— 26 published items with date-precision and verification flags. The chronology →/agents/concepts.json— 35 concept records, parsed from the concepts index rather than retyped. The glossary →/doctrine/doctrine.json— 40 doctrine records with evidence links. The assessment →/screenshots/targets.jsonandcaptured.json— the 30 capture targets with their licence strings, and what actually happened to each.
All of it CC BY 4.0. Every markdown document carries the stamp, and the release gate fails the build if one does not.