title: What is this "generated" option in Sphinx autosummary directive?
body: <p>I'm using sphinx-apidoc and autosummary extensions to document an API for a library and I'm really unable to understand the purpose of the <code>generated/</code> option below:</p>
  
  <pre><code>.. autosummary::
     :nosignatures:
     :toctree: generated/
  
     module.function_1
     module.function_2
     ...
  </code></pre>
  
  <p>I've seen this is the Sphinx documentation, and in libraries like pandas.  I'm using <code>toctree</code> and my API is autogenerating, but I don't understand what generated is.  I don't see a folder called generated, and don't know what the advantage/purpose of this is.</p>
  
  <p>Thanks</p>