fix :returns: and add pep-0257

1 files changed, 5 insertions, 1 deletions

diff --git a/HACKING b/HACKING
index 4e0dfc835..e58d60e58 100644
--- a/HACKING
+++ b/HACKING
@@ -57,8 +57,12 @@ Docstrings
   parameters and return types use the Sphinx format. After that an extra
   newline then close the quotations.
 
+  When writing the docstring for a class, an extra line should be placed
+  after the closing quotations. For more in-depth explanations for these
+  decisions see http://www.python.org/dev/peps/pep-0257/
+
   :param foo: the foo parameter
   :param bar: the bar parameter
-  :rtype: the return type
+  :returns: description of the return value
 
   """