title: How to format Django views' docstring
body: <p>I use simple views in my project, and now my project begin to be bigger, I'm writing a sphinx doc and use objects docstrings with <code>sphinx.ext.autodoc</code> for inclusion.</p>
  
  <p>My trouble is: How to greatly format view's docstring ?</p>
  
  <ul>
  <li>Document GET/POST and more behavior.</li>
  <li>Template(s) used</li>
  <li>Context content</li>
  </ul>
  
  <p>For example, I'm using:</p>
  
  <pre><code>def my_view(request):
      """
      Do something depending of HTTP method.
  
      In GET: Returns a page
      IN POST: Make something and redirect
  
      GET parameters:
      GET['next'] : URL to redirect to after submit form
  
      POST parameters:
      POST['action'] : Action
      """
  </code></pre>
  
  <p>I'm self-asking if there is a better way to do this ?
  Is there any consensus about it ?</p>