title: How can I get Sphinx autosummary to generate full API documentation for classes, as well as a *summary table* for those classes?
body: <p>I'm sure this is user error at one level or another but I'm going mad slowly here and would really appreciate some help. </p>
  
  <p>I've gotten both <a href="https://www.sphinx-doc.org/en/master/man/sphinx-apidoc.html" rel="noreferrer"><code>sphinx-apidoc</code></a> and the excellent third party <a href="https://sphinx-autoapi.readthedocs.io/en/latest/index.html" rel="noreferrer"><code>sphinx-autoapi</code></a> to work, but can't repeat the trick with <a href="https://www.sphinx-doc.org/en/master/usage/extensions/autosummary.html" rel="noreferrer"><code>sphinx.ext.autosummary</code></a>. It's driving me mad... plus neither of these options give you the really neat package/module member summary tables that are (presumably) the main selling point of <code>sphinx.ext.autosummary</code>.</p>
  
  <p>I have a really simple project:</p>
  
  <pre><code>|_ TEST
     |_ docs
        |_ conf.py
        |_ index.rst
     |_ myproject
        |_ __init__.py
        |_ mymodule.py
  </code></pre>
  
  <p><code>conf.py</code> looks like this:</p>
  
  <pre class="lang-py prettyprint-override"><code>import os
  import sys
  sys.path.insert(0, os.path.abspath('../../myproject'))
  
  extensions = [
      'sphinx.ext.autodoc',
      'sphinx.ext.autosummary'
  ]
  
  autosummary_generate = True
  </code></pre>
  
  <p><code>index.rst</code> looks like this:</p>
  
  <pre><code>.. autosummary::
     :toctree: _autosummary
  
     myproject.mymodule
  </code></pre>
  
  <p><code>mymodule.py</code> looks like this:</p>
  
  <pre class="lang-py prettyprint-override"><code>"""
  Module containing a class and a function.
  """
  
  class TestClass:
      """
      A class representing a test.
  
      I wish I could get this to stuff to show up but I can't and I don't know why.
  
      Why isn't this documentation visible?!? :-(
      """
      def __init__(self):
          """
          Instantiate.
          """
          pass
  
      def Func_in_test_class(self):
          """
          Cool function that does stuff.
  
          :return: Some new stuff.
          """
          pass
  
  def GlobalFunc():
      """
      Utility function.
  
      Does some good stuff.
      """
      pass
  </code></pre>
  
  <p>Running <code>make html</code> from the <code>docs</code> directory makes this lovely Readthedocs-style HTML:</p>
  
  <p><img src="https://i.stack.imgur.com/8HDLh.png" alt="(see picture)"></p>
  
  <p>What I want to do is click on the <code>TestClass</code> function in the summary table and visit a new page that shows the API documentation for this class in full. How can I achieve that?</p>
  
  <p>(Or am I missing the point, and I have to combine <code>sphinx.ext.autosummary</code> with <code>sphinx-apidoc</code> to get what I need..?)</p>