📖 [Docs]: Release bumps now have a configurable default

[Marius Storhaug (MariusStorhaug)]

Repositories can configure their normal semantic version bump through DefaultBump. Explicit owned bump labels override that policy, prereleases reuse the resolved bump, and release:skip remains the publication stop.

Changed: Release bumps have a safe repository default

DefaultBump accepts patch, minor, or major and resolves to patch when omitted. A pull request can override it with one owned bump label; conflicting owned labels fail, while bare and unrelated labels remain ignored.

---

Technical details

• The Release Management specification and design define the configuration, resolution order, validation, and prerelease behavior.
• Automation Labels, PR Format, Continuous Delivery and Release, Branching and Merging, Natural Language examples, and the VS Code Extension Framework use the same contract.
• The optional workflow_dispatch path still requires an explicit bump and release-note context.
• Empty pull requests and direct pushes remain excluded as ad hoc release interfaces.
• Dependency-tool guidance, implementation repositories, and fleet labels are unchanged.
• Issue convergence sweep: no open MSXOrg/docs issue matching DefaultBump, default bump, release label, or release management is fully satisfied by this diff.

Changed surface	Standards checked	Framework docs checked	Result
src/docs/Capabilities/release-management/**	Natural Language, Markdown	Release Management	Aligned
src/docs/Capabilities/vscode-extension-framework/**	Natural Language, Markdown	Release Management, VS Code Extension Framework	Aligned
src/docs/Ways-of-Working/**	Natural Language, Markdown	Release Management	Aligned
src/docs/Coding-Standards/Natural-Language.md	Natural Language, Markdown	Release Management	Aligned

Relevant issues (or links)

Related work

• References 📖 [Docs]: Release decisions use owned labels #188

[Copilot]

Pull request overview

This PR updates the MSX documentation set to introduce a configurable repository-wide default semantic version bump (DefaultBump) for release automation, while keeping owned release:* labels as explicit overrides and updating prerelease semantics to reuse the resolved bump.

Changes:

• Define DefaultBump (defaulting to patch) and the override / conflict rules in Release Management spec + design.
• Update Ways of Working guidance (PR format, CD/release, branching/promotion, automation labels) to reflect “policy-first” bump selection and prerelease behavior.
• Align the VS Code Extension Framework spec/design with the Release Management contract.

Reviewed changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
src/docs/Ways-of-Working/PR-Format.md	Documents how release:pre-release interacts with DefaultBump and owned bump-label overrides.
src/docs/Ways-of-Working/Continuous-Delivery-And-Release.md	Updates CD/release “decision at the gate” language to reference resolved release policy and DefaultBump.
src/docs/Ways-of-Working/Branching-and-Merging.md	Updates promotion-model guidance to use the resolved policy / DefaultBump with explicit overrides.
src/docs/Ways-of-Working/Automation-Labels.md	Reframes label meanings around DefaultBump + owned label overrides and conflict handling.
src/docs/Coding-Standards/Natural-Language.md	Updates example language/error-message guidance to reflect conflicting owned bump labels and DefaultBump.
src/docs/Capabilities/vscode-extension-framework/spec.md	Updates framework requirements/success criteria to match policy-driven bump selection.
src/docs/Capabilities/vscode-extension-framework/design.md	Updates pipeline/design narrative to reference release policy and DefaultBump in version resolution.
src/docs/Capabilities/release-management/spec.md	Defines the normative DefaultBump rules, override precedence, prerelease behavior, and label conflict handling.
src/docs/Capabilities/release-management/index.md	Updates the section index descriptions to match the refreshed spec/design framing.
src/docs/Capabilities/release-management/design.md	Documents configuration surface and pipeline behavior for resolving DefaultBump + owned label overrides.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Copilot]

Pull request overview

Copilot reviewed 10 out of 10 changed files in this pull request and generated no new comments.