Re: [Python-Dev] status of development documentation
I wrote:
My own favorite idea is to create a comment-on-the-docs mechanism allowing both COMMENTS, and PROPOSED EDITS.
Fred Drake replies:
I'm unclear on what you buy with having these two labels; are comments things that (presumably) get ignored by the documentation editor, or are the proposed edits simply more specific?
Things that get ignored by the doc editors.
(I'm also concerned that the whole thing could end up being misused as a help desk, littering the docs with questions about application problems.)
Me too. Specifically, I think if you make it really easy to write notes on the docs you will get some helpful documentation content. You will also get lots of things that are too lengthy or exhaustive, to specific to one person's problem, helpdesk style questions, and probably spam. All I meant was to allow the contributor to specify which category they think this particular note belongs to so the doc editors can read only the ones that people thought ought to be included in the docs. -- Michael Chermside
2005/12/22, Michael Chermside
(I'm also concerned that the whole thing could end up being misused as a help desk, littering the docs with questions about application problems.)
Me too. Specifically, I think if you make it really easy to write notes on the docs you will get some helpful documentation content. You will also get lots of things that are too lengthy or exhaustive, to specific to one person's problem, helpdesk style questions, and probably spam. All
I sent a mail to MySQL folks, asking them some feedback about the dynamics of their documentation annotation system (regarding this issues, spam, etc.). Let's see if they answer. . Facundo Blog: http://www.taniquetil.com.ar/plog/ PyAr: http://www.python.org/ar/
Michael Chermside wrote:ลก
Me too. Specifically, I think if you make it really easy to write notes on the docs you will get some helpful documentation content. You will also get lots of things that are too lengthy or exhaustive, to specific to one person's problem, helpdesk style questions, and probably spam.
fwiw, the effbot.org useredit mechanism results in nice patches, suggestions, occasional questions, and, in periods, huge amounts of spam (from spammers who treat it as an ordinary wiki). </F>
participants (3)
-
Facundo Batista
-
Fredrik Lundh
-
Michael Chermside