Commit cff7c65
chore(readme): flip to single-source .adoc + derived .md (ADR-004 pilot)
boj-server is one of two estate repos with a genuine Markdown-only consumer
(Glama, which renders README.adoc as raw markup). Per ADR-004, flip it from a
hand-authored README.md to authored README.adoc + CI-derived README.md:
- README.adoc: new canonical source (bootstrapped from the prior README.md
via the ADR-004 recipe; sets :idprefix:/:idseparator: - so the TOC anchors
resolve on GitHub and re-derive cleanly).
- README.md: now a GENERATED artefact (banner stamped; do not hand-edit).
Verified faithful: 11/11 TOC anchors resolve, 12/12 badges intact (incl.
Glama), blockquote + inline code round-trip clean.
- ECOSYSTEM.a2ml: [publishing.readme] declaration (consumer=glama) — the
machine-readable opt-in the derive workflow reads.
- .github/workflows/readme-derive.yml: caller for the standards reusable;
regenerates + freshness-checks README.md on changes.
Local verification (pandoc 3.10 + asciidoctor 2.0.26): vocab gate 98.7%,
normalised freshness byte-identical, anchor guard satisfied.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>1 parent ed5c741 commit cff7c65
4 files changed
Lines changed: 406 additions & 64 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
| 29 | + | |
| 30 | + | |
| 31 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
48 | 48 | | |
49 | 49 | | |
50 | 50 | | |
| 51 | + | |
| 52 | + | |
| 53 | + | |
| 54 | + | |
| 55 | + | |
| 56 | + | |
| 57 | + | |
| 58 | + | |
| 59 | + | |
| 60 | + | |
| 61 | + | |
| 62 | + | |
0 commit comments