conf.py
----
* Import extension sphinx.ext.extlinks for rewriting/shortening URLs.
* Define extlinks vol-{git,ger,jira} for documenting.
howto/edit_voltha_docs.rst
----
* Build out docs for make lint and make html.
* Include iamge files from an earlier howto patch to help get content in.
howto/voltha_repositories.rst
----
* Pull in docs from another howto patch.
* Describe gerrit and git repos.
Bump the copyright revision string to 2022.
Change-Id: Iacc139d764682d586c2cd88150c8e1795e479662
diff --git a/howto/voltha_repositories.rst b/howto/voltha_repositories.rst
new file mode 100644
index 0000000..73897e8
--- /dev/null
+++ b/howto/voltha_repositories.rst
@@ -0,0 +1,56 @@
+.. _voltha_repositories:
+
+VOLTHA project repositories
+===========================
+
+Finding a repository to work with
+---------------------------------
+
+Navigate to the VOLTHA repositories on gerrit or github:
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+- :vol-ger:`voltha-docs`
+- :vol-git:`voltha-docs`
+
+- https://github.com/opencord/voltha-docs
+
+|
+
+Visit gerrit.opencord.org/dashboard
+"""""""""""""""""""""""""""""""""""
+
+.. figure:: images/gerrit_dashboard.png
+ :alt: Gerrit dashboard
+ :width: 70%
+ :align: center
+
+|
+
+From the BROWSE pull-down menu select Repositories
+""""""""""""""""""""""""""""""""""""""""""""""""""
+.. figure:: images/menu_repositories.png
+ :alt: BROWSE pull-down menu selection
+ :align: center
+
+|
+
+In the Filter: box search for 'voltha-'
+"""""""""""""""""""""""""""""""""""""""
+
+- Click browse to view repository clone command and available versions.
+- Click branch=master to browse the code base.
+
+.. figure:: images/repository_select_VOLTHA.png
+ :alt: voltha- repository search
+ :width: 70%
+ :align: center
+
+|
+
+
+Github
+++++++
+A mirror of the VOLTHA gerrit repositories can also be found on github.
+
+- https://github.com/opencord/voltha-docs
+
+ - Gerrit repositories can also be accessed through a mirror on github.