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
--
http://mail.python.org/mailman/listinfo/python-list
