------------------
GIT is a powerful tool allowing many actions, but without respecting some rules
-the GIT structure can be quickly ugly and unmaintaible.
+the GIT structure can be quickly ugly and unmaintainble.
Here are some conventions about GIT branches:
- ALWAYS create a local branch to edit or create any file. This local branch
git clone http://gerrit.onap.org/r/doc
-Update submodules, build documentation using tox & then open using any browser.
+Build documentation using tox local environment & then open using any browser.
.. code-block:: bash
firefox docs/_build/html/index.html
.. note:: Make sure to run `tox -elocal` and not just `tox`.
+
+There are additional tox enviornment options for checking External URLs and Spelling.
+Use the tox environment options below and then look at the output with the Linux `more` or
+similar command for scanning for output that applies to the files you
+are validating.
+
+.. code-block:: bash
+
+ tox -elinkcheck
+ more < docs/_build/linkcheck/output.txt
+
+ tox -espellcheck
+ more < docs/_build/spellcheck/output.txt
+