Add instructions about branching 39/32839/3
authorYujun Zhang <zhang.yujunz@zte.com.cn>
Sat, 1 Apr 2017 02:38:25 +0000 (10:38 +0800)
committerYujun Zhang <zhang.yujunz@zte.com.cn>
Sat, 1 Apr 2017 23:30:19 +0000 (07:30 +0800)
Change-Id: Iecaabe34dcc2eabf520d0b2793edad26b4b0df79
Signed-off-by: Yujun Zhang <zhang.yujunz@zte.com.cn>
docs/testing/developer/devguide/overview.rst

index 1d7e22f..06a6914 100644 (file)
@@ -79,6 +79,20 @@ The test cases are written in `pytest`_. You may run it selectively with
 
     pytest tests/unit/reporter
 
+
+Branching
+=========
+
+Stable branches are created when features are frozen for next release. According to
+`OPNFV release milestone description`_, stable branch window is open on MS6 and closed on MS7.
+
+#. Contact gerrit admin <opnfv-helpdesk@rt.linuxfoundation.org> to create branch for project.
+#. Setup `qtip jobs`_ and `docker jobs`_ for stable branch in releng
+#. Follow `instructions for stable branch`_.
+
+NOTE: we do **NOT** create branches for feature development as in the popular `GitHub Flow`_
+
+
 .. _Connexion: https://pypi.python.org/pypi/connexion/
 .. _Click: http://click.pocoo.org/
 .. _Jinja2: http://jinja.pocoo.org/
@@ -87,3 +101,8 @@ The test cases are written in `pytest`_. You may run it selectively with
 .. _sphinx: http://www.sphinx-doc.org/en/stable/
 .. _The Hitchhiker's Guide to Python: http://python-guide-pt-br.readthedocs.io/en/latest/writing/structure/
 .. _tox: https://tox.readthedocs.io/
+.. _OPNFV release milestone description: https://wiki.opnfv.org/display/SWREL/Release+Milestone+Description
+.. _qtip jobs: https://git.opnfv.org/releng/tree/jjb/qtip/
+.. _docker jobs: https://git.opnfv.org/releng/tree/jjb/releng/opnfv-docker.yml
+.. _instructions for stable branch: https://wiki.opnfv.org/display/SWREL/Stablebranch
+.. _GitHub Flow: https://guides.github.com/introduction/flow/