.gitignore was ignoring a documentation directory so added am explicit pattern retain it
Change-Id: I5db8220a95bc0a0b2b360db5588d70ef763e4599
diff --git a/.gitignore b/.gitignore
index e65eff4..9e8406b 100644
--- a/.gitignore
+++ b/.gitignore
@@ -17,6 +17,8 @@
voltha-protos
voltha-system-tests
voltctl
+!howto/release/voltctl
+
cord-tester
device-management-interface
diff --git a/VERSION b/VERSION
index 6d27db5..cf686df 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-2.10.15
+2.10.16
diff --git a/howto/release/voltctl/index.rst b/howto/release/voltctl/index.rst
new file mode 100644
index 0000000..99b00f7
--- /dev/null
+++ b/howto/release/voltctl/index.rst
@@ -0,0 +1,10 @@
+HOWTO(s)
+========
+
+.. toctree::
+ :maxdepth: 2
+
+ release/voltctl/install
+ release/voltctl/release
+
+:ref:`voltctl-see-also`
diff --git a/howto/release/voltctl/install.rst b/howto/release/voltctl/install.rst
new file mode 100644
index 0000000..29bbf3d
--- /dev/null
+++ b/howto/release/voltctl/install.rst
@@ -0,0 +1,15 @@
+Command: installVoltctl.groovy
+==============================
+
+Release Notes
+-------------
+The `repo:ci-management :: vars/installVoltctl.groovy <https://gerrit.opencord.org/plugins/gitiles/ci-management/+/refs/heads/master/vars/installVoltctl.groovy>`_ script is used to install a versioned voltctl binary when working with LTS or an older released version.
+
+During release the install program will require an edit to capture the HEAD version of voltctl.
+
+See Also
+--------
+ * `vars/installVolthactl.groovy <https://gerrit.opencord.org/plugins/gitiles/ci-management/+/refs/heads/master/vars/installVoltctl.groovy>`_
+ * `VOLTHA Release Process <https://docs.voltha.org/master/release_notes/release_process.html?highlight=release>`_
+
+:ref:`voltctl-see-also`
diff --git a/howto/release/voltctl/release.rst b/howto/release/voltctl/release.rst
new file mode 100644
index 0000000..ac6502b
--- /dev/null
+++ b/howto/release/voltctl/release.rst
@@ -0,0 +1,37 @@
+VOLTHA Release: voltctl
+=======================
+
+Release Builds howto:
+---------------------
+- Increment the VERSION file to a major or minor point release.
+- Initiate a jenkins job to build components (WIP: searching).
+- Verify a `tag <https://github.com/opencord/voltctl/tags>`_ named for the version was created.
+- `Released version <https://api.github.com/repos/opencord/voltctl/releases/latest>`_ consumed by jenkins installer vars/installVoltctl.groovy.
+
+|
+
+Create an official voltctl release
+----------------------------------
+- `installVoltctl.groovy <https://gerrit.opencord.org/plugins/gitiles/ci-management/+/refs/heads/master/vars/installVoltctl.groovy#53>`_
+ depends on `releases/latest <https://api.github.com/repos/opencord/voltctl/releases/latest>`_ for versioned release information.
+
+ - To generate a release visit `github <https://github.com/opencord/voltctl>`_.
+ - Click `Releases <https://github.com/opencord/voltctl/releases>`_ in the right margin.
+
+ - Click "Draft a new release"
+ - Select a tag name to base the release on.
+ - Title the relese and enter a description (release notes).
+ - Select the checkbox "Set as the latest release".
+ - Verify release information in the right margin upon return to the main repository screen.
+
+- Verify the release version contains a checksum file:
+
+ - checksum.SHA256
+ - voltctl-1.7.6-darwin-amd64
+ - voltctl-1.7.6-linux-amd64
+ - voltctl-1.7.6-linux-arm64
+ - voltctl-1.7.6-windows-amd64
+ - Source code (zip)
+ - Source code (tar.gz)
+
+:ref:`voltctl-see-also`
diff --git a/howto/release/voltctl/see_also.rst b/howto/release/voltctl/see_also.rst
new file mode 100644
index 0000000..b1757ce
--- /dev/null
+++ b/howto/release/voltctl/see_also.rst
@@ -0,0 +1,24 @@
+.. _voltctl-see-also:
+
+See Also
+--------
+
+voltctl
+=======
+ * voltctl
+
+- Command: `voltctl <https://github.com/opencord/voltctl/>`_
+
+ - `released version(s) <https://github.com/opencord/voltctl/releases>`_
+ - `tags <https://github.com/opencord/voltctl/tags>`_
+
+ * `VOLTHA Releases <https://docs.voltha.org/master/overview/releases.html>`_
+ * `VOLTHA Release Process <https://docs.voltha.org/master/release_notes/release_process.html?highlight=release>`_
+ * `vars/installVolthactl.groovy <https://gerrit.opencord.org/plugins/gitiles/ci-management/+/refs/heads/master/vars/installVoltctl.groovy>`_
+ * `helm charts <https://docs.voltha.org/master/voltha-helm-charts/README.html?highlight=voltctl>`_
+ * `Install votlctl <https://docs.voltha.org/master/voltha-helm-charts/README.html?highlight=voltctl#installing-and-configuring-voltctl>`_
+
+- github:
+
+ - `About releases <https://docs.github.com/en/repositories/releasing-projects-on-github/about-releases>`_
+ - `Releases API <https://docs.github.com/en/rest/releases?apiVersion=2022-11-28>`_