Skip to content

Clarify release expectations: add tagging policy and align versioning language#703

Open
rohansood10 wants to merge 1 commit intodapr:masterfrom
rohansood10:fix/8188-clarify-release-expectations
Open

Clarify release expectations: add tagging policy and align versioning language#703
rohansood10 wants to merge 1 commit intodapr:masterfrom
rohansood10:fix/8188-clarify-release-expectations

Conversation

@rohansood10
Copy link

Summary

Addresses dapr/dapr#8188 — Release Expectations: Clarify discrepancies and update to be easier for end users to understand.

Changes

Updates release-process.md to address the four items raised by the CNCF TOC:

  1. Align language between release process and support policy — Expanded the versioning section with a clear table matching the MAJOR/MINOR/PATCH definitions used in the supported releases documentation, and added explicit cross-references between the two documents.

  2. Align maturity tagging between core Dapr and components — Added a dedicated section explaining that components follow their own maturity lifecycle (alpha → beta → stable) independent of the core Dapr release version, with a link to the component certification lifecycle docs.

  3. Add a tagging policy — New "Tagging policy" section documenting the tag formats for stable releases, release candidates, and security/bug fix patches, for both core Dapr repos and components-contrib.

  4. Clarify stable vs unstable vs security/bug releases — Each release type is now explicitly defined with tag format examples and guidance on production readiness. GitHub release annotation conventions (Latest vs Pre-release) are also documented.

Additional improvements

  • Fixed typos (candencecadence, correspondigcorresponding)
  • Reorganized the section into clearer subsections (Versioning, Tagging policy, Branching)

Files changed

  • release-process.md — 1 file, ~71 insertions, ~35 deletions

Risk

Low — Documentation-only change. No code, tests, or runtime behavior affected.

… language

Address dapr/dapr#8188 by:
- Adding an explicit tagging policy section covering core Dapr releases,
  component releases, and GitHub release annotations
- Defining release types (stable, release candidate, security/bug fix)
  with clear tag format examples
- Aligning versioning language between this document and the supported
  releases documentation
- Clarifying the relationship between component maturity lifecycle and
  core release versioning
- Fixing minor typos (cadence, corresponding)

Signed-off-by: rohansood10 <rohansood10@users.noreply.github.com>
@rohansood10 rohansood10 marked this pull request as ready for review February 22, 2026 18:03
@rohansood10
Copy link
Author

Friendly ping — any chance to review this when you get a moment? Happy to make changes if needed.

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