osimons wrote: > The NewHelp branch is working, and more or less (more less than > more :-) in sync with trunk. It got left to "mature" while waiting for > Sphinx-ification, but Noah has assured me that it should be quite easy > to get done as a provider.
Is Sphinx-ification even necessary before merging newhelp into trunk? Couldn't the current wiki pages just be kept (obviously with all links changed to [help:...] or [doc:...]) and conversion to Sphinx be done in a second step? > I'm starting to lean towards making it into > a generic 'Documentation' container that can provide a "resolve and > view container" for any purpose. In the simplest implementation it > just gets abstracted one level, so that the 'realm' becomes 'docs' > instead of 'help', and every installation ships with a 'trac-guide' > documentation set that basically follows the current approach (api, > plugins and help providers). This sounds like an excellent idea! > for instance read files in repos. I see that as a very valuable feature as well. > Sphinx, Doxygen, Epydoc and similar could likely easily fit into this > scheme, as of course could any other means of provinding rendered > content at a given path. reStructuredText, javadoc, ... > Does a 'Library' section make sense as part of Trac? It makes a lot of sense (to me, at least). -- Remy
signature.asc
Description: OpenPGP digital signature
