On Thu, Jun 5, 2008 at 9:34 PM, Mike Orr <[EMAIL PROTECTED]> wrote: > > On Thu, Jun 5, 2008 at 8:51 AM, Kevin G. Baker <[EMAIL PROTECTED]> wrote: >> This is an interesting point. It might make sense to start a documentation >> standard. One that all these projects could embrace moving forward. If the >> docs were all in a standard format, like "man", they could be easily >> combined for projects like Pylons and other frameworks, sort of Legos for >> documentation. "Open Doc Blocks" ... ;) >> >> Something like this would help reduce redundancy, sort of normalization of >> docs, and might improve overall documentation support on a lot of projects >> >> Just a thought... does anyone know if there is any sort of standard like >> this? I tend to use Natural Docs for its easy skinning and support for it's >> multi-language and multi-doc syntax support. But this would only cover API >> docs... >> >> - Kevin Baker > > Sphinx looks likely to become it. Both Pylons and Paste have switched > to it, as has Python's development versions. See:
We at TurboGears have also switched to Sphinx for tg2: http://turbogears.org/2.0/docs/index.html Florent. --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "pylons-discuss" 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/pylons-discuss?hl=en -~----------~----~----~----~------~----~------~--~---
