On Tue, Oct 14, 2008 at 1:57 PM, Remy Blank <[EMAIL PROTECTED]> wrote: > 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 > >
This sounds like a great idea. I currently do not have automagically generated API documentation in the Trac wiki because it's completely unmaintainable. It would be great if that information was available seamlessly in Trac rather than hosting it seperately. I'm thinking specifically about HTML-ified JavaDocs that get produced as part of a build, so maybe it would be a good idea have a "publish docs" module for Bitten too. :-) -- Mat Booth www.matbooth.co.uk --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "Trac Development" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/trac-dev?hl=en -~----------~----~----~----~------~----~------~--~---
