Using Sphinx to document multiple Python pojects
<p>I'm getting started using Sphinx. I've read a few tutorials but I'm still a bit hung up on how I set up multiple projects.</p>

<p>What I mean is, after installing sphinx, <a href="https://pythonhosted.org/an_example_pypi_project/sphinx.html" rel="nofollow">this guide</a> says</p>

<blockquote>
  <p>To get started, cd into the documentation directory and type: <code>$ sphinx-quickstart</code></p>
</blockquote>

<p>Let's say I have 5 separate Python projects each in it's own directory (all individual git repos, etc).</p>

<p><strong>My question is, what exactly is <em>"the documentation directory"</em> (aside from the obvious) and how do I set up Sphinx when working with multiple projects?</strong></p>

<p>Do I make one "master documentation directory" somewhere and as I use Sphinx, do I create sub directories for each project or similar?</p>

<p>Or do I create a "documentation directory" inside of each of my projects and run <code>$ sphinx-quickstart</code> to set up Sphinx for each individual project?</p>

<p>I'm trying to understand the big picture here but cant find a tutorial that spells out this aspect of things.</p>

<p>The <code>sphinx-quickstart</code> command generates a documentation skeleton for <em>a single project</em>, so if you have multiple separate projects you will have to run it in each one of them. The link you posted uses the phrase <em>"documentation directory"</em> because the directory name and relative position in the project directory is up to you (they appear to be putting it in <code>project_root/doc</code>), not because there should be some centralised directory of documentation for all of your projects. </p>

python documentation python-sphinx autodoc