Skip to content

docs(adr): 0047 a break waits for a minor release that a feature brings - #293

Merged
ShortArrow merged 1 commit into
mainfrom
docs/adr-0047-version-policy
Oct 20, 2026
Merged

ShortArrow merged 1 commit into
mainfrom
docs/adr-0047-version-policy

Conversation

@ShortArrow

@ShortArrow ShortArrow commented Oct 20, 2026 •

Copy link
Copy Markdown
Owner

ADR 0047 §2 said only that a break of the --json or config.toml contract needs a minor version. It did not say when a minor version is cut, or whether a change in what a setting does counts as a break. The timeout_ms change (#250) fell into that gap. It made unchanged configurations stop slow measurements, and it was prepared as 0.4.1 (#288) before it was moved into 0.5.0 (#291).

§2 now says three things.

  • The config.toml contract covers what a value does as well as how it is spelled. Under that reading, timeout_ms broke it.
  • A minor version is cut for a feature large enough to carry one, and the breaks that are waiting ride along with it. A break alone does not move the minor version, so breaks are released together, not one minor version each.
  • While a break waits on main, main cuts no patch release. A fix owed to the current minor line ships from a maintenance branch under ADR 0022's existing rule.

The last point follows from the first two. Without it, a patch cut from main would carry the waiting break, which §2 already forbids.

@ShortArrow
ShortArrow marked this pull request as ready for review October 20, 2026 00:54
@ShortArrow
ShortArrow merged commit f3c1bad into main Oct 20, 2026
19 checks passed
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