title: Formatting python docstrings for dicts
body: <p>What's the recommended way of adding a docstring for a dictionary parameter? I can see multiple line docstring examples <a href="http://legacy.python.org/dev/peps/pep-0257/#multi-line-docstrings" rel="noreferrer">here</a>.</p>
  
  <p>I need to document the input arguments to a function in the docstring. If it's a simple variable, I can use something like:</p>
  
  <pre><code> def func2(a=x, b = y):
   """ fun2 takes two integers 
  
   Keyword arguments:
   a -- refers to age (default 18)
   b -- refers to experience (default 0)
   """
  </code></pre>
  
  <p>If we have <code>dict</code> passed as input argument to function:</p>
  
  <pre><code> def func3(**kwargs):
       """ takes dictionary as input
  
        &lt;Here how to explain them - Is it like?&gt; 
        kwargs['key1'] -- takes value1
  
        &lt;or simply&gt;
        key1 -- takes value1
        """
  </code></pre>