title: Keeping the API updated in Sphinx
body: <p>The scheme is the following. There exists a package called <code>foo</code> (an API under heavy development, in first alpha phases) whose <code>rst</code> files are auto generated with <code>sphinx-apidoc</code>.</p>
  <p>For the sake of having a better documentation for <code>foo</code> after those files are generated, there is some editing. In, say, <code>foo.bar.rst</code> there are some paragraphs added to the contents generated with <code>sphinx-apidoc</code></p>
  <p>How can I not loose all that information when a new call of <code>sphinx-apidoc</code> is made? And of course I want potential changes in the API to be reflected, with that manual information added being preserved.</p>