Re: [PHP-DOC] About note maintenance; when to delete notes.

2012-03-19 Thread Philip Olson
On Mar 17, 2012, at 6:13 AM, Maciek Sokolewicz wrote: On 15-03-2012 18:10, Jesus M. Castagnetto wrote: If memory serves, at some point there were places that hosted code snippets. How about, and this is a pie-in-th-sky idea, if we offer something like that, a community-ranked collection of

Re: [PHP-DOC] About note maintenance; when to delete notes.

2012-03-17 Thread Maciek Sokolewicz
On 15-03-2012 18:10, Jesus M. Castagnetto wrote: If memory serves, at some point there were places that hosted code snippets. How about, and this is a pie-in-th-sky idea, if we offer something like that, a community-ranked collection of snippets, that may be associated to one or more manual

Re: [PHP-DOC] About note maintenance; when to delete notes.

2012-03-15 Thread Jesus M. Castagnetto
Indeed, here (Lima, Peru) I had done some app reviews where the code was copied either from the PHP Manual or from the notes, even from the examples on how not do things in the security chapter. It would be funny if (at least in one case) this code was not being used for sensitive stuff (tracking

Re: [PHP-DOC] About note maintenance; when to delete notes.

2012-03-15 Thread Jesus M. Castagnetto
Daniel I am with you on this. Saying no is not easy, because sometimes offends the person whose contribution is being removed. Most understand that it is a judgement call on their contribution no on their person, but some do not understand that and can even turn to flaming. Only thing to do is to

Re: [PHP-DOC] About note maintenance; when to delete notes.

2012-03-13 Thread Hannes Magnusson
On Sun, Mar 11, 2012 at 10:04, Maciek Sokolewicz maciek.sokolew...@gmail.com wrote: On 11 March 2012 02:40, Jesus M. Castagnetto je...@castagnetto.com wrote: Sorry to come so late in this discussion. But there are guidelines for more than a decade on how to handle notes:    

Re: [PHP-DOC] About note maintenance; when to delete notes.

2012-03-13 Thread Daniel Brown
On Fri, Feb 24, 2012 at 16:54, Maciek Sokolewicz maciek.sokolew...@gmail.com wrote: A few days ago I deleted a note, and the author sent a mail to the php-general list complaining about it. The answer by Dan was basically that the notes maintainers are overzealous and the author should contact

Re: [PHP-DOC] About note maintenance; when to delete notes.

2012-03-10 Thread Jesus M. Castagnetto
Sorry to come so late in this discussion. But there are guidelines for more than a decade on how to handle notes: http://doc.php.net/php/dochowto/chapter-user-notes.php Just in case you did not see it: User Note Editing Guidelines These are some guidelines to follow when editing user notes

[PHP-DOC] About note maintenance; when to delete notes.

2012-02-24 Thread Maciek Sokolewicz
I've been maintaining notes in the manual off and on since I came to the PHP project, quite a few years ago. A few days ago I deleted a note, and the author sent a mail to the php-general list complaining about it. The answer by Dan was basically that the notes maintainers are overzealous and

Re: [PHP-DOC] About note maintenance; when to delete notes.

2012-02-24 Thread Ronald Chmara
On Fri, Feb 24, 2012 at 1:54 PM, Maciek Sokolewicz maciek.sokolew...@gmail.com wrote: The reason I'm using such strict guidelines is simply to make the manual notes readable. If you look at a page such as http://www.php.net/manual/en/function.strtotime.php, there are 100 notes present.

Re: [PHP-DOC] About note maintenance; when to delete notes.

2012-02-24 Thread Maciek Sokolewicz
On 24-02-2012 23:12, Ronald Chmara wrote: On Fri, Feb 24, 2012 at 1:54 PM, Maciek Sokolewicz maciek.sokolew...@gmail.com wrote: The reason I'm using such strict guidelines is simply to make the manual notes readable. If you look at a page such as