Repository navigation
Define settings-driven default release bumps #225
Description
Context and request
Define a configurable automatic release bump in the existing MSXOrg/docs#196 guidance. The user chose DefaultBump to replace a patch-specific AutoPatching switch: documented defaults make automation usable, supported caller settings change that default, and an explicit owned bump label overrides the effective setting.
Acceptance criteria
- The guidance explains the effective documented default, supported patch/minor/major choices, caller overrides, and explicit-label precedence consistently.
- A valid effective default supplies a release level without requiring a bump label on every PR; invalid settings and conflicting owned signals fail explicitly.
- Canonical mode and stop labels are release:prerelease and release:skip; dependency metadata and bare labels do not select a release level.
- Release, PR-format, continuous-delivery, and applicable framework references agree without silently reverting the reconciled mainline consumer-evidence contract.
- Existing documentation validation and the complete review loop pass, and the existing PR conflicts are resolved without discarding other work.
Technical decisions
Use existing PR #196, preserving its distinct settings proposal and coordinating overlapping changes with #209/#208 under one owner. Reuse the shared smart-defaults/local-overrides principle and retain public setting precedence in the release capability. Date-based versioning remains an idea, not a supported value or implementation requirement. This Task changes canonical guidance, not producer code, labels, rulesets, or publication state. CI enforcement is tracked separately by #166 through the native dependency.
Implementation plan
- Inspect the complete current candidate/main differences and identify all default-policy and label references before editing.
- Establish checks for default/override/prerelease/skip/error cases in the guidance.
- Align the canonical settings and dependent references with those cases while preserving separately scoped PR intent.
- Reconcile conflicts and execute existing documentation checks and the complete Copilot review loop.
- Record settings decisions and acceptance evidence in PR Release guidance uses configurable default bumps #196 and link this Task with a closing reference.
Release settings filename revision
The user-directed filename is .github/release.settings.yml; only the filename changes. Preserve the settings/default/override contract and all unrelated interfaces. Landed #209/main aa9b5cecc69f4cbe6aa04a5dd70ff9cdadeeac3d supplies the complete PR-record, release-range-first, and no-template-file contracts during the authorized consistency reconciliation. The canonical filename follow-up has a separate owner; no unmerged delivery is copied here.
- Locate all owned filename references and establish regression failures before editing.
- Update the owned release/default guidance and directly relevant tests.
- Reconcile landed main while preserving the DefaultBump/keyed-route scope and verify exact shared-page composition with the canonical filename owner.
- Run documentation validation and current-head review, then push the scoped revision.
Existing human/source/lineage/prerequisite holds remain; automatic merging is not authorized.
Activity