Python docs disappointing - group effort to hire writers?

Jean-Michel Pichavant jeanmichel at sequans.com
Fri Aug 7 04:55:51 EDT 2009


alex23 wrote:
> Paul Rubin <http://phr...@NOSPAM.invalid> wrote:
>   
>> The PHP docs as I remember are sort of regular (non-publically
>> editable) doc pages, each of which has a public discussion thread
>> where people can post questions and answers about the topic of that
>> doc page.  I thought it worked really well.  The main thing is that
>> the good stuff from the comment section gets folded into the actual
>> doc now and then.
>>     
>
> I'd still like to see this kept out of the official docs as much as
> possible, mostly for reasons of brevity & clarity. I think the
> official docs should be considered definitive and not require a
> hermeneutic evaluation against user comments to ensure they're still
> correct...
>
> How about a secondary site that embeds the docs and provides
> commenting functionality around it? That's certainly a finitely scoped
> project that those with issues about the docs could establish and
> contribute to, with the possibility of it gaining official support
> later once it gains traction.
>
>
>
>   
Very good Idea. I'd like to get a commented/user improved python 
documentation site with examples and I also love the current python 
documentation.

JM



More information about the Python-list mailing list