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
-~----------~----~----~----~------~----~------~--~---

Reply via email to