Add section about version control repos

index.rst

@@ -19,6 +19,7 @@ This is documentation by and for members of the MOAD (Mesoscale Ocean and Atmosp
    :maxdepth: 2
    :caption: Contents:
 
+   vcs_repos
    hg_version_control
    compute-canada
    globus

vcs_repos.rst

@@ -0,0 +1,44 @@
+.. Copyright 2018-2020 The UBC EOAS MOAD Group
+.. and The University of British Columbia
+..
+.. Licensed under a Creative Commons Attribution 4.0 International License
+..
+..   http://creativecommons.org/licenses/by/4.0/
+
+
+.. _team-repos:
+
+Version Control Repositories
+============================
+
+Our Git version control repositories are collected in organizations on GitHub:
+
+* https://github.com/UBC-MOAD/
+* https://github.com/SalishSeaCast/
+* https://github.com/MIDOSS/
+
+In early 2020 we are in the process of migrating all of our Mercurial repositories from Bitbucket to Git repositories on GitHub due to Bitbucket's decision to end support for Mercurial.
+While they still exist,
+our Mercurial repositories are collected in teams on Bitbucket:
+
+* https://bitbucket.org/UBC_MOAD/
+* https://bitbucket.org/SalishSea-MEOPAR/
+* https://bitbucket.org/CanyonsUBC/
+* https://bitbucket.org/CCAR-modeling/
+* https://bitbucket.org/MIDOSS/
+
+* People in the group are free to push changes to :kbd:`master` branches,
+  or use feature branches and GitHub pull requests as they see fit.
+  External contributors should fork repos and create pull requests to provide changes so that they are reviewed.
+
+* Many repos have issue trackers enabled on GitHub
+
+* GitHub wikis are disabled on all repos to force documentation into repo docs directories
+
+* Docs use Sphinx_
+
+  .. _Sphinx: http://sphinx-doc.org/
+
+* Docs from public repos will be rendered as HTML on readthedocs.org.
+
+* There is no provision for rendering docs from private repos.