Document jenkins view creation, updated some navigation and toc indexes that were rendering strangely
Change-Id: I452d85c246f833dbe15b80e50fed0dce82c5c56f
diff --git a/howto/release/ci-management/create_lts_view.rst b/howto/release/ci-management/create_lts_view.rst
new file mode 100644
index 0000000..0eedd5e
--- /dev/null
+++ b/howto/release/ci-management/create_lts_view.rst
@@ -0,0 +1,65 @@
+Jenkins job views: VOLTHA-LTS
+=============================
+
+Intent
+------
+
+With each new VOLTHA LTS release (v2.11, v2.8) a jenkins view will need
+to be created to allow running regression tests. This page will document
+those instructions.
+
+LTS Folder
+----------
+Visit `jenkins::Dashboard <https://jenkins.opencord.org>`_ and create a
+VOLTHA-LTS folder if one does not exist.
+
+- Click ``New Item`` in the left margin.
+- For ``item name`` type in VOLTHA-LTS
+- Click Folder or Copy from an existing folder.
+- Uncheck "Add to current view"
+- Click the OK button
+
+Jenkins job view: global
+------------------------
+
+Two view creation options are available
+
+- global - all jobs are selectable
+- local - simple list creation
+
+Global job view creation
+------------------------
+
+- Visit `jenkins::Dashboard <https://jenkins.opencord.org>`_
+- Click "New View" in the left margin.
+- Name view for the current release VOLTHA-XXX
+- Select type "List View"
+- Accept basic values to begin configuring
+- Add an appropraite job Description.
+- Scroll down to "Job Filters"
+
+ - Selelect individual jobs
+ - Select "Use a regular expression to include jobs in the view", value: .*voltha-2.11.*
+
+- The voltha-2.8 view deleted the "Coverage" and "Favorite" columns.
+- The voltha-2.11 view is complete for now.
+- Click the "create" button
+
+Add job view in the LTS folder
+------------------------------
+
+- Visit `jenkins::Dashboard <https://jenkins.opencord.org>`_
+- Click the `VOLTHA-LTS folder <https://jenkins.opencord.org/job/VOLTHA-LTS/>`_ in center.
+- Click "New View" in the left margin.
+- Add view name: VOLTHA-2.11
+- Select "Include a global view"
+- Click the "create" button
+- Type in an appropraite Description.
+- View name should contain the global view name VOLTHA-2.11
+- Click "Apply"
+- Click "OK"
+
+Access LTS jobs
+---------------
+- Visit the `VOLTHA-LTS job folder <https://jenkins.opencord.org/job/VOLTHA-LTS/>`__
+- Select or bookmark job view VOLTHA-2.11.
diff --git a/howto/release/ci-management/index.rst b/howto/release/ci-management/index.rst
index 6a69d0f..eb7d2e4 100644
--- a/howto/release/ci-management/index.rst
+++ b/howto/release/ci-management/index.rst
@@ -1,27 +1,13 @@
repo:ci-management
==================
-General
--------
+Intro
+-----
-For an LTS release (v2.11, v2.8) tests on the master branch will need
-to be copied into a named voltha-version folder and updated to checkout
-and exercise tests and source on that branch.
+Jenkins and repo:ci-management edits needed for a VOLTHA-X.Y release.
-`Jenkins Views <https://jenkins.opencord.org/>`_
-------------------------------------------------
-Begin by creating voltha-{LST} views for the new pipeline jobs.
+.. toctree::
+ :maxdepth: 1
-jjb/software-upgrades.yaml
---------------------------
-
-- Create a new software-upgrades-test-0211 branch from the old.
-- Update released component versions mentioned in the configs.
-- Update master branch released versions as well.
-- Tricky part, SNAPSHOT versions are not visible to navigation browsing:
-
- - `org/opencord <https://oss.sonatype.org/content/groups/public/org/opencord>`_
-
-- Instead obtain snapshot version from pom.xml and type in the explicit URL path:
-
- - `aaa-app/2.9.0-SNAPSHOT <https://oss.sonatype.org/content/groups/public/org/opencord/aaa-app/2.9.0-SNAPSHOT/>`_
+ create_lts_view
+ jjb_software_upgrades
diff --git a/howto/release/ci-management/jjb_software_upgrades.rst b/howto/release/ci-management/jjb_software_upgrades.rst
new file mode 100644
index 0000000..23e64cc
--- /dev/null
+++ b/howto/release/ci-management/jjb_software_upgrades.rst
@@ -0,0 +1,15 @@
+jjb/software-upgrades.yaml
+--------------------------
+
+- Create a new software-upgrades-test-voltha-2.11 branch from master or existing
+ jjb definitions in the yaml config file.
+- Update released component version strings mentioned in the configs.
+- Update master branch released versions as well.
+- Tricky part, SNAPSHOT versions are not visible to navigation browsing:
+
+ - `org/opencord <https://oss.sonatype.org/content/groups/public/org/opencord>`_
+
+- Instead obtain snapshot version from pom.xml and type in the explicit URL path:
+
+ - `aaa-app/2.9.0-SNAPSHOT <https://oss.sonatype.org/content/groups/public/org/opencord/aaa-app/2.9.0-SNAPSHOT/>`_
+