title: How should I document lists, optionals, and yields using Google-style Sphinx?
body: <p>How do I indicate types for lists, optional arguments and return types for generators on Google-style docstrings using Sphinx-Napoleon?</p>
  
  <p>I've tried</p>
  
  <pre><code>List[type]
  list of type
  
  Optional[type]
  type, optional
  </code></pre>
  
  <p>and</p>
  
  <pre><code>Yields:
     type: 
  </code></pre>
  
  <p>respectively; but all produce unsatisfactory output that is not consistent with the rest of the generated documentation. For example </p>
  
  <pre><code>Optional[type]
  </code></pre>
  
  <p>just gives</p>
  
  <blockquote>
    <p>Optional[type]</p>
  </blockquote>
  
  <p>without any link for <code>type</code>.</p>
  
  <p>I've tried every builtin theme and have the same issues.</p>
  
  <p>How should I be documenting these elements using Google-style docstrings with Sphinx-Napoleon?</p>