Versions Compared

Old Version 67

changes.mady.by.user Tanja de Groot

Saved on

compared with

New Version Current

changes.mady.by.user Tanja de Groot

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

WIP

Table of Contents

Introduction

A CAMARA meta-release is the way CAMARA brings its APIs to market.

A meta-release consists of a set of public versions of curated APIs that went though the CAMARA meta-release process.

The purpose of this document is to describe define

  • the milestones of the meta-release (this page), and the supporting Meta-release Process documentation
  • the activities expected from the different teams to move from one milestone to the next
  • the way to report progress on the meta-release itself, on the Commonalities and ICM releases and on API releases

For the , expected tasks, and references the supporting processes used in the CAMARA meta-release cycle.See CAMARA meta-releases for schedule and content of actual planned meta-releases, see CAMARA meta-releases.

Meta

...

-release milestones

Meta-release milestones and their associated actions are used to progress and track the status of the meta-release. 

  • A meta-release has 6 milestones, M0 through M6 described below. 
  • For the typical milestone dates of a meta-release, please see

...

Release milestones and their associated actions are used to progress and track the status of the meta-release.

The actions required from the various teams in the release process are described in the table below.

NOTE: alternate table format proposed under review here: FOR REVIEW: Updated table of CAMARA Release Process - CAMARA Project - Confluence

The following table lists the meta-release milestones, and includes a high level view of the activities expected from the various teams to reach these milestones. 

More details on these for each team are documented here: 


Milestone / start date

Actors & Activities for next milestone

Timeline

Week Nr

pre-M0 activities
  • Release Management: prepare meta-release plan
  • Commonalities & ICM: define scope and start alpha release development
  • TSC: declare M0 - meta-release kickoff


M0 

Meta-release kickoff

M00
activities for M1 start @ M0
  • Commonalities & ICM: fix scope and develop final alpha release for M1
  • API Sub Groups: check Commonalities and ICM scope definition to assess API impact
  • TSC: approve Commonalities and ICM scope and final alpha release
  • Release Management: Declare M1 - Commonalities and ICM alpha release available
2 weeks

M1

Alpha Commonalities & ICMM0 + 2 weeks2
activities for M2 start @ M1
  • API Sub Groups: align to Commonalities and ICM alpha release and provide feedback
  • Commonalities & ICM: Fix bugs and prepare final release-candidate for M2
  • TSC: approve Commonalities and ICM final release-candidate
  • Release Management; declare M2 - Commonalities and ICM release-candidate available
7 weeks

M2

Release-candidate Commonalities & ICMM1 + 7 weeks9
activities for M3 start @ M1
  • API Sub Projects: prepare API scope and develop alpha releases, ending by the first release-candidate for M3
  • TSC: review scope of APIs (case by case selection)
  • Release Management: check API readiness of each API and declare M3 - all API first release-candidates available
9 weeks

M3

Release-candidate APIs (Code Freeze)

M1 + 9 weeks

9
activities for M4 start @ M3
  • API Sub Projects: fix bugs and prepare public-release
  • Commonalities & ICM: prepare public-release
  • Release Management: check API readiness of each API and declare M4 - all API public-releases available
  • TSC: give formal approval of Commonalities, ICM and API (case-by-case) public-releases
9 weeks

M4

Public-release APIs

M3 + 9 weeks

18

activities for M5 starts @ public-release PR for an API

  • Release Management: prepare and declare M5 - meta-release availability
  • TSC: approve meta-release for M5
2 weeks

M5

Meta
MilestoneMilestone NameActions to achieve milestone

Timeline

Week number

Kickoff - M0Start of meta-release cycle.M00

M1

Initiate Commonalities & ICM
  • Scope of Work Products clarified  and recorded in dedicated issue.
  • Identify commonalities work products.
  • Create alpha release for Commonalities & ICM
  • Create initial PRs for commonalities.
  • Agree on the scope of commonalities.
  • TSC review.
M0 + 2 week2

M2

Finalize Commonalities & ICM
  • Create release-candidate for Commonalities & ICM
  • Prepare public-release for Commonalities & ICM.
  • Complete initial PR reviews.
  • TSC Approval.
M1 + 10 weeks12

M3

Initiate Sub-projects / APIs
  • Scope Request to Sub-Projects / APIs.
  • Determine requirements for Sub-projects / APIs.
  • Create PRs for Sub-projects / APIs.
  • Review and finalize PRs.
  • Confirm scope of Sub-projects / APIs 
  • Define API test cases.
  • Define acceptance criteria.
  • Create alpha release for for Sub-projects / APIs.

M1 + 8 weeks

10

M4

Finalize Sub-projects / APIs
  • Conduct testing and log test result.
  • Evaluate and log acceptance criteria.
  • Code Freeze
  • Create release-candidate for Sub-Projects / APIs.
  • Prepare public-release for Sub-Projects / APIs.
  • Request approval of Sub-projects / APIs to Release Management WG for meta-release

M3 + 10 weeks

20

M5

Meta Release
  • Determine the acceptance of the release-candidates for inclusion in the meta-release
  • Bundle & publish meta-release
  • TSC Approval
    • Publish meta
    -releaseM4 + 2 weeks
    22
    20
    activities for M6
    Post- Release
    • Review release process and identify areas for improvement. 
    • Release Retro.
      • Inputs from Sub Projects
    • TSC Approval.
    M5 + 2 weeks24

    Release contacts 

    Meta-releases are administered and tracked by

    • the CAMARA Release Managers, supported by
    • the release contacts of the Commonalities and ICM working groups 
    • the release contacts of the API Sub-projects

    The teams can put their release contact names on the Release Contacts (Maintainers) page or put the release contact on their API release trackers.

    Team release contacts need to subscribe to the release management mailing list.

    All communication on an ongoing meta-release and its progress will be managed through this mailing list.

    start @ M5
    • Commonalities & ICM: assess meta-release and provide feedback
    • API Sub Groups: assess meta-release and provide feedback
    • Release Management: assess meta-release, create improvement plan and declare M6 - post-release assessment available
    • TSC: approve improvement plan for M6
    		2 weeks

    M6

    		Post Release AssessmentM5 + 2 weeks24

    Processes

    All CAMARA teams play their part in the meta-release process. The actions are listed An overview of the activities per team is shown in the above milestone table.

    Additional information The details on the actions activities for all teams each team can be found in the below process descriptions:

    • The process to manage a meta-release is described here: Meta-release Process
    • The process for the Commonalities and ICM teams is described here: Commonalities and ICM release process
    • Details on releasing an API version and the related API versioning are described here: API Release Process. 

    ...