doc: Add some useful tools for doc editing

This has come up on the mailing list. Let's document it!

Signed-off-by: Stephen Finucane <stephen@that.guru>
Signed-off-by: Ben Pfaff <blp@ovn.org>

diff --git a/Documentation/internals/contributing/documentation-style.rst b/Documentation/internals/contributing/documentation-style.rst
index 318cc81ef9ba95598401f4d48803b726ddf6b448..a3149ba6dbf7af83febbe3c4cadd4b9fe0ed4601 100644 (file)
--- a/Documentation/internals/contributing/documentation-style.rst
+++ b/Documentation/internals/contributing/documentation-style.rst
@@ -35,12 +35,15 @@ documents found in the project tree.
 reStructuredText vs. Sphinx
 ---------------------------
 
-reStructuredText (reST) is the syntax, while Sphinx is a documentation
+`reStructuredText (reST)`__ is the syntax, while `Sphinx`__ is a documentation
 generator.  Sphinx introduces a number of extensions to reST, like the
 ``:ref:`` role, which can and should be used in documentation, but these will
 not work correctly on GitHub. As such, these extensions should not be used in
 any documentation in the root level, such as the ``README``.
 
+__ http://docutils.sourceforge.net/rst.html
+__ http://www.sphinx-doc.org/
+
 reST Conventions
 ----------------
 
@@ -325,9 +328,29 @@ vSwitch documentation. These guidelines are based on the `IBM Style Guide
 
   Avoid "please" and "thank you"
 
+Helpful Tools
+-------------
+
+There are a number of tools, online and offline, which can be used to preview
+documents are you edit them:
+
+- `rst.ninjs.org <http://rst.ninjs.org/>`__
+
+  An online rST editor/previewer
+
+- `ReText <https://github.com/retext-project/retext>`__
+
+  A simple but powerful editor for Markdown and reStructuredText. ReText is
+  written in Python.
+
+- `restview <https://mg.pov.lt/restview/>`__
+
+  A viewer for ReStructuredText documents that renders them on the fly.
+
 Useful Links
 ------------
 
-* `Quick reStructuredText
+- `Quick reStructuredText
   <http://docutils.sourceforge.net/docs/user/rst/quickref.html>`__
-* `Sphinx Documentation <http://sphinx.readthedocs.org/en/latest/rest.html>`__
+
+- `Sphinx Documentation <http://sphinx.readthedocs.org/en/latest/rest.html>`__