Re: Re: Notes Status, 23323 total

From: Date: Sun, 15 Dec 2013 18:00:06 +0000
Subject: Re: Re: Notes Status, 23323 total
References: 1 2 3  Groups: php.doc php.notes 
Request: Send a blank email to phpdoc+get-969384769@lists.php.net to get a copy of this message
On 15/12/13 17:44, Sherif Ramadan wrote:
What do you mean by so often? This list seems to be fairly new. The first one I see in the archives was early November and there appear to be a total of 4 of them since then. So it seems to be either on a weekly or bi-weekly basis, as far as I can tell. I also find that it serves as a good reminder that people on the documentation team (all of whom have notes Karma) aren't moderating the user contributed notes, nearly often enough.
It was the weekly basis I was referring to with the "often".
Often it is the case that a page with too many user-contributed notes has a lot of repeat information or too many examples of the same thing. One of the objectives behind user notes is to incorporate them into the documentation if they present something the documentation is currently lacking. So ultimately, a page that has too many user notes is an indication that it's not being moderated closely enough. Clearly, we don't need 18 different examples to show you how to use cookies in curl, for instance. We also should remove user notes - like this one http://www.php.net/manual/en/function.curl-setopt.php#93108 - which state that the documentation is lacking information that it's not. That particular note is over 4 years old, so I don't know if at some point the docs were indeed missing that information, that the user claims was missing, but it no longer is.
Right, I see. I'm not really meaning to complain, more curious about why these emails are sent. I see the value of it better now, thanks. -- Andrea Faulds http://ajf.me/

« previous php.doc (#969384769) next »