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