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