Skip to content

governance: no rfc: issue during 0.x; the RFC comes back at the v1.0 freeze or with a second implementation - #15

Merged
coderoast-dev merged 1 commit into
mainfrom
governance/no-rfc-during-0x
Oct 2, 2026
Merged

coderoast-dev merged 1 commit into
mainfrom
governance/no-rfc-during-0x

Conversation

@coderoast-dev

Copy link
Copy Markdown
Collaborator

What changes

During the 0.x draft line, a breaking change no longer needs an rfc: issue or a 14-day comment window. The editor merges it with a MINOR bump, which §6 already allows during 0.x.

Why: a comment window protects implementers that a change would break. Today the reference implementation is the only producer and consumer of MetaLog documents, so the window protects no one and only delays a correction the editor has already decided.

What is kept. The pull request still states the change as a diff against SPEC.md and gives its migration impact (items 2 and 4 of an RFC issue). CHANGELOG.md records it as breaking in the same pull request. Only the wait is dropped, not the record.

The RFC comes back, and the editor cannot waive it.

  • At the v1.0 freeze (ADR 0001): every breaking change and every profile takes an rfc: issue and the Process at 1.0+ column.
  • Earlier, still in 0.x, the day a second implementation is listed in README.md's implementation table. From then on a breaking change can break someone other than the editor. ADR 0001's first freeze condition requires a second implementation, so this always happens before the freeze.

Files

  • GOVERNANCE.md:
    • §2: the 0.x cell of the Breaking row changes, and a new subsection Breaking changes during 0.x covers the rule, what replaces the window, and the two triggers that bring the RFC back.
    • §5 step 3: the comment window applies only where §2 requires one.
  • CONTRIBUTING.md: the process step points at §2 instead of an unconditional RFC process.
  • CHANGELOG.md (0.10.0, unreleased): records that RFC rfc: 0.10.0 — close the extension boundary, make the diff's MUST decidable, and give the composed document its own caps #8 is closed. P2 already landed in 0.10.0. P1, P3 and P4 remain proposed, and any that is taken lands as an editor change recorded there.

conformance/metalog_validate.py --selftest passes 31/31. No schema or SPEC.md text changes, so no document's validity moves.

Closes #8.

🤖 Generated with Claude Code

…omment window; the RFC comes back at the v1.0 freeze, or earlier the day a second implementation is listed (closes #8)

The reference implementation is today the only producer and consumer, so a
comment window protects no one. The pull request still states the SPEC.md diff
and the migration impact, and CHANGELOG.md records the change as breaking.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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.

rfc: 0.10.0 — close the extension boundary, make the diff's MUST decidable, and give the composed document its own caps

1 participant