On 07/13/2011 07:31 AM, John Dulaney wrote:
Ok, kind of expanding on this, would it be possible to set up Sphinx so that it does the autodoc thing with code and devel documentation, but also pull from the Wiki for user doc? The Wiki content would still have to be human authored, but I don't see why Sphinx can't pull from that. Am I making sense here?
That would certainly help make any packaged documentation more complete but it would be quite a bit of work and I think that the current perception is that we don't have enough other users to justify that. I've seen tools for going from rST (what Sphinx uses) to mediawiki but not the other way around.
I'm also not a fan of requiring network access in order to build the docs. If something is going to be built locally, the source should be stored locally or at least cached locally to allow for building without network access after the first time.
Tim