Change CONTRIBUTING to ReST, use better docstring syntax

1 files changed, 21 insertions, 0 deletions

diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
new file mode 100644
index 00000000..539da50f
--- /dev/null
+++ b/CONTRIBUTING.rst
@@ -0,0 +1,21 @@
+This repository has a mandatory code review policy. Contributions
+should happen through pull requests. Never commit to ``master``
+directly.
+
+When in doubt, refer to PEP 8 for Python code.
+
+Write docstrings like this::
+
+  def some_function(some_arg):
+      """
+      Does some things.
+
+      :param some_arg: Some argument.
+      """
+
+So, specifically:
+
+- Always use three double quotes.
+- Put the three double quotes on their own line.
+- No blank line at the end.
+- Use Sphinx parameter/attribute documentation syntax.