VOL-5244 - branch and release voltha-protos.
howto/release/components/voltha-protos.rst
------------------------------------------
o Document steps for releasing repo:voltha-protos.
[HOWOT: test]
% make help
% make lint
% make linkcheck
% make reload
URL: http://localhost:5500/howto/release/components/index.html
Navigation: HOWTO -> Release Topcis -> VOLTHA Components -> repo:voltha-protos
Change-Id: Ibb49a445d961bcf6e5a4e3032fa1347c39af5f6e
diff --git a/VERSION b/VERSION
index d94526e..9634e38 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-2.12.11
+2.12.12
diff --git a/howto/release/components/voltha-lib-go.rst b/howto/release/components/voltha-lib-go.rst
index 22ec852..0dd0300 100644
--- a/howto/release/components/voltha-lib-go.rst
+++ b/howto/release/components/voltha-lib-go.rst
@@ -1,4 +1,4 @@
-VOLTHA Components: voltha-protos
+VOLTHA Components: voltha-lib-go
================================
Dependencies
diff --git a/howto/release/components/voltha-protos.rst b/howto/release/components/voltha-protos.rst
index 9de5270..6e4e108 100644
--- a/howto/release/components/voltha-protos.rst
+++ b/howto/release/components/voltha-protos.rst
@@ -9,7 +9,10 @@
Validate
--------
+- make help
- make lint
+- make protos
+- make build
- make test
Versioning
@@ -17,9 +20,49 @@
- Based on VERSION file contents in root directory of the repository.
-Release
--------
+Release Preparation
+-------------------
+
+- Create a jira ticket for tracking the repo:voltha-protos upgrade.
+- Update copyright notice in source to span the current year.
+- Regenerate voltha.pb file:
+
+ - make clean
+ - make voltha.pb
+ - voltha.pb is checked in, should it be ?!?
+ - File is .PHONY, always rebuilt, is a static copy needed for usage or bootstrapping ?
- Bump VERSION file to a non-dev semantic version.
- See Validate above
- Commit and approve to trigger a build
+
+Release Branching and Tagging
+-----------------------------
+
+- Create and tag release branch (voltha-2.12)
+- Update .gitreview file contents to checkin on the release branch:
+
+ - defaultbranch=voltha-2.12
+
+- Commit and merge after jenkins job passes.
+
+Post Release Action
+===================
+
+- Clone master branch from repository.
+- Bump VERSION file to next minor version with a ``*-dev`` suffix.
+
+ - ie {major}.{minor+1}.0.``-dev``
+
+- Future checkins on master must not conflict with release branch versioning.
+
+Jira Tickets
+============
+
+- Create a jira ticket for tracking the repo:voltha-protos upgrade.
+- Create sub-tasks attached to the jira ticket to track jenkins job failures.
+- Close the ticket after
+
+ - Release branch created
+ - VERSION file edit on master has bumped version to {major}.{minor+1}.0.``-dev``
+ - All jenkins jobs for repo:voltha-protos reports PASS.