Skip to content

[DO NOT MERGE] Proposed implementation plan for automated release workflow#338

Draft
hdamker wants to merge 9 commits intocamaraproject:mainfrom
hdamker:release-process-implementation-plan
Draft

[DO NOT MERGE] Proposed implementation plan for automated release workflow#338
hdamker wants to merge 9 commits intocamaraproject:mainfrom
hdamker:release-process-implementation-plan

Conversation

@hdamker
Copy link
Collaborator

@hdamker hdamker commented Nov 25, 2025

[UPDATED] This PR description has been updated to reflect the restructured plan targeting a Mass Rollout strategy by Jan 15, 2026. It's not intended to be merged, but available here for information. Relevant are the issues in ReleaseManagement.

What type of PR is this?

documentation

What this PR does / why we need it:

This PR adds comprehensive documentation proposing the implementation of the CAMARA automated release workflow concept defined in CAMARA-Release-Workflow-and-Metadata-Concept.md.

The implementation plan has been restructured into 7 distinct phases to support a Mass Rollout Strategy:

  • 7 Implementation Phases from November 2025 through Fall 2026
  • 18 sub-issues with clear dependencies
  • Timeline alignment targeting Jan 15, 2026 for full adoption
  • Mass Rollout Strategy: Automated campaign to onboard all ~61 repositories at once

Key deliverables:

  1. Phase 1: Concept & Preparation (Nov-Dec 2025): Metadata schemas, Presentation for Dec 10 All Hands.
  2. Phase 2: Mass Rollout (Dec 2025 - Jan 15, 2026):
    • Automated PR campaign to all ~61 repositories using project-administration tooling.
    • Minimal validation ("sanity check") to ensure rapid adoption.
    • Immediate Wiki Replacement: Embedding Release Progress Tracker to replace manual tables.
  3. Phase 3: Validation Framework (Jan 2026): Stable CI validation configuration for Fall26 cycle start.
  4. Phase 4: Release Automation (Jan-Feb 2026): Automated release branch generation functional for early adoptors Spring26 M3 (Jan 31).
  5. Phase 5-7: Release Operations, Maintenance, and Deferred Topics.

The plan addresses:

  • Mass Rollout: Shifting from "early adopters" to "all repositories" by Jan 15 to completely replace the wiki tracker.
  • Minimal Initial Validation: Lightweight checks for rollout, followed by robust Phase 3 validation.
  • Modular Architecture: Direct linter integration (Spectra, YAML-lint) and custom validators.

Which issue(s) this PR fixes:

Related to #191

Special notes for reviewers:

  • Mass Rollout (Phase 2): The strategy now targets all repositories by Jan 15, 2026, using an automated campaign.
  • Wiki Integration: Moved to Phase 2 to provide immediate value (replacing manual tracking tables).
  • Timeline: Critical deadline is Jan 15, 2026 for adoption.
  • Validation: "Minimal validation" for rollout (Phase 2) vs. "Full validation framework" (Phase 3).
  • Commonalities Reference: Uses concrete releases (e.g., r3.4) rather than meta-release references.

Changelog input

Add proposed implementation plan for automated release workflow with 7 phases, focusing on a Mass Rollout strategy of release-plan.yaml by Jan 15, 2026

Additional documentation

Includes:

  • documentation/SupportingDocuments/CAMARA-Release-Workflow-Implementation-Plan.md: Comprehensive phased implementation plan
  • documentation/SupportingDocuments/CAMARA_Release_Rrocess_coverage_o_fall_25.md: Workflow categories (C1-C5) mapping

Copy link
Contributor

@albertoramosmonagas albertoramosmonagas left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A few comments, but everything is fine 👍

hdamker and others added 8 commits January 5, 2026 13:35
This commit adds comprehensive documentation proposing the
implementation of the CAMARA automated release workflow concept:

- CAMARA-Release-Workflow-Implementation-Plan.md: Proposed phased
  implementation plan with 5 phases from Nov 2025 to Fall 2026,
  including 20 sub-issues, timeline alignment, and success criteria

- CAMARA_Release_Rrocess_coverage_o_fall_25.md: Workflow categories
  (C1-C5) and topic-by-topic coverage mapping from wiki page

Key aspects of the proposed plan:
- Phase 1A (Nov-Dec 2025): Metadata schemas and Release Progress
  Tracker integration with presentation on Dec 10
- Phase 1B (Dec 2025-Jan 2026): Validation framework stable by
  mid-Jan for Fall26 cycle start
- Phase 2 (Jan-Feb 2026): Release automation functional by Spring26
  M3 (Jan 31)
- Phases 3-5: Full rollout, maintenance workflow, and production
  hardening through Fall 2026

Related to camaraproject#191
Rationale:
- Consistency: Existing tooling (api_review_validator, validate-release-plan)
  is already Python-based.
- Simplicity: Python scripts using standard libraries avoid the overhead of
  node_modules and build steps for simple local validation tasks.
- Suitability: Python is well-suited for the required file I/O, git operations,
  and semantic version parsing needed for these context-aware checks.
- Alignment: Ensures the plan matches the actual implementation direction.
- Renumber phases to 1-7 (Concept, Rollout, Validation, Automation, Ops, Maint, Deferred)
- Shift Phase 2 (Rollout) deadline to Jan 15, 2026
- Define Mass Rollout Strategy targeting all ~61 repositories
- Add detailed deliverables for automated campaign and minimal validation
- Move Wiki Integration to Phase 2 for immediate value
- Update issues list camaraproject#191.1-camaraproject#191.18 and dependencies
- Manual adjustments to issue placement and estimation logic
- Add Table of Contents
Co-authored-by: Alberto Ramos Monagas <alberto.ramosmonagas@telefonica.com>
Clarify certain lists are examples not definitive:
- Custom validators (actual list TBD)
- Presentation materials (content TBD)
- Checklist automation (capabilities TBD)
- Success criteria numbers updated to TBD where appropriate
@hdamker hdamker force-pushed the release-process-implementation-plan branch from e02b7d7 to 68baad7 Compare January 5, 2026 12:36
- Update Timeline Alignment table with detailed Fall26 milestones (M0-M4)
- Fix Success Criteria headers (remove incorrect phase labels)
- Update Phase 4 objectives to target Feb 28 for Spring26 M4
- Remove Next Steps section (superseded by GitHub issues)
@hdamker hdamker changed the title Add proposed implementation plan for automated release workflow [DO NOT MERGE] Proposed implementation plan for automated release workflow Feb 5, 2026
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.

2 participants