Skip to content

docs(plan): convert RFD checklists and tooling to AsciiDoc - #50

Merged
darwin67 merged 1 commit into
rfd-5-ci-mvpfrom
rfd-adoc-migration
Sep 24, 2026
Merged

darwin67 merged 1 commit into
rfd-5-ci-mvpfrom
rfd-adoc-migration

Conversation

@darwin67

Copy link
Copy Markdown
Member

Scope

Stacked on #49. Merge the planning PR first, then retarget this PR to main.

Replace all five Org implementation checklists with actual AsciiDoc, updating links, repository guidance, and the RFD status checker and regression fixtures. Preserve prose, task completion, phase status, and RFD lifecycle states. No runtime behavior changes.

Completed/total task counts are unchanged:

  • RFD 1: 34/34
  • RFD 2: 40/40
  • RFD 3: 129/129
  • RFD 4: 13/30
  • RFD 5: 0/23

Validation

  • RFD status checker and regression tests passed, independently rerun by the coordinator.
  • Migration worker verified Nix flake check, Cargo format, Clippy with warnings denied, workspace tests, and shell syntax checks.
  • Migration worker rendered all five checklists with Asciidoctor 2.0.26 without warnings and checked content preservation and local links.
  • No Org files remain under rfd. Completed checkboxes use AsciiDoc lowercase x; the existing partial marker remains documented as text.

Existing Phase 0 work in the original checkout was left untouched.

Replace every rfd/NNNN/IMPLEMENTATION.org with IMPLEMENTATION.adoc written in
AsciiDoc syntax: == sections, link:README.adoc[..] backlinks, */** checklist
bullets, and a Status: DONE./Status: TODO. line where the Org property drawer
was. Completed tasks use [x], because Asciidoctor does not recognize [X] as a
checkbox.

scripts/check-rfd-status.sh now requires IMPLEMENTATION.adoc, rejects a retired
IMPLEMENTATION.org or IMPLEMENTATION.md, counts [ ], [x], [*], and the partial
[-], and ignores tasks in ----, ...., ////, //, and inline code. [X] is
reported as an invalid task state. The regression fixtures cover nested,
partial, alternate-checked, and example-block cases.

rfd/README.adoc, AGENTS.md, the RFD cross-links, and docs/time-model.adoc now
name the AsciiDoc checklist. Task counts are unchanged: 34/34, 40/40, 129/129,
13/30, and 0/23.
@darwin67
darwin67 added this pull request to stack #51 September 24, 2026 15:21
@darwin67
darwin67 merged commit 83ebd1f into main Sep 24, 2026
6 checks passed
@darwin67
darwin67 deleted the rfd-adoc-migration branch September 24, 2026 15:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant