Hi all, 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. We'll see if we can get this working soon.
However, I have been thinking about the scope of the feature. It is currently restricted to 'Help/Guide' documentation by Trac and plugins - in one or more locales. 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). For instance, for the Trac project itself, that means we can make another documentation provider (plugin) that uses some completely other way of doing things - for instance read files in repos. Using something like a common 'Library' sidebar, we can display any kind of documentation. The Trac project may have this library of independent documentation: | Help/Guide | (basically newhelp - like .../docs/trac-guide/ WikiFormatting) | Trac 0.10.x documentation | (these are from repos - like .../docs/ trac-010/WikiFormatting) | Trac 0.11.x documentation | | Trac trunk documentation | 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. Does a 'Library' section make sense as part of Trac? :::simon https://www.coderesort.com --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
