summaryrefslogtreecommitdiffstats
path: root/tools/moztreedocs/docs/rstlint.rst
diff options
context:
space:
mode:
Diffstat (limited to 'tools/moztreedocs/docs/rstlint.rst')
-rw-r--r--tools/moztreedocs/docs/rstlint.rst12
1 files changed, 12 insertions, 0 deletions
diff --git a/tools/moztreedocs/docs/rstlint.rst b/tools/moztreedocs/docs/rstlint.rst
new file mode 100644
index 0000000000..230ba2e812
--- /dev/null
+++ b/tools/moztreedocs/docs/rstlint.rst
@@ -0,0 +1,12 @@
+ReStructuredText Linter
+-----------------------
+
+RST isn't the easiest of markup languages, but it's powerful and what `Sphinx` (the library used to build our docs) uses, so we're stuck with it. But at least we now have a linter which will catch basic problems in `.rst` files early. Be sure to run:
+
+.. code-block:: shell
+
+ mach lint -l rst
+
+to test your outgoing changes before submitting to review.
+
+`More information <RST Linter>`__.