Added my first google style api docstring

doc/source/conf.py

@@ -30,7 +30,8 @@
 
 # Add any Sphinx extension module names here, as strings. They can be extensions
 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = ['sphinx.ext.autodoc', 'sphinx.ext.intersphinx', 'sphinx.ext.todo', 'sphinx.ext.viewcode']
+extensions = ['sphinx.ext.autodoc', 'sphinx.ext.intersphinx', 'sphinx.ext.todo',
+              'sphinx.ext.viewcode', 'sphinx.ext.napoleon']
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']

lizard_auth_server/views_api_v2.py

@@ -204,6 +204,23 @@ def get(self, request, *args, **kwargs):
         return super(VerifyCredentialsView, self).get(request, *args, **kwargs)
 
     def form_valid(self, form):
+        """Return user data when credentials are valid
+
+        Args:
+            form: A :class:`lizard_auth_server.forms.JWTDecryptForm`
+                instance. It will have the JWT message contents in the
+                ``cleaned_data`` attribute. ``form.site`` is set to the site
+                that asks us the question.
+
+        Returns:
+            A dict with key ``user`` with user data like first name, last
+            name.
+
+        Raises:
+            PermissionDenied: when the username/password combo is invalid or
+                when the user has to access to the site (via its company).
+
+        """
         # The JWT message is OK, now verify the username/password and send
         # back a reply
         user = django_authenticate(username=form.cleaned_data.get('username'),