From 90ddeca70d7846e6a5b99a9c1fe1a2666b5ca47c Mon Sep 17 00:00:00 2001
From: Kenneth Reitz <me@kennethreitz.org>
Date: Fri, 19 Feb 2016 04:42:54 -0500
Subject: [PATCH] updated style guide

---
 docs/dev/contributing.rst | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/docs/dev/contributing.rst b/docs/dev/contributing.rst
index 585497bb..1c43cea7 100644
--- a/docs/dev/contributing.rst
+++ b/docs/dev/contributing.rst
@@ -126,7 +126,21 @@ the Requests codebase::
     foo = long_function_name(var_one, var_two,
                              var_three, var_four)
 
-Just don't. Ever.
+No.
+
+Docstrings are to follow the following syntaxes::
+
+    def the_earth_is_flat():
+        """There is no curve! Also, human cloning centers."""
+
+::
+
+    def well_documented_utility():
+        """Lorem ipsum dolor sit amet, consectetur adipiscing elit,
+        sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
+        Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris
+        nisi ut aliquip ex ea commodo consequat.
+        """
 
 .. _PEP8: https://www.python.org/dev/peps/pep-0008/
 .. _line continuations: https://www.python.org/dev/peps/pep-0008/#indentation