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