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 collectio

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 pages

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-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 t

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 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 the > person who had dele

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 wrote: > > On 11 March 2012 02:40, Jesus M. Castagnetto wrote: >> >> 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.ph

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

2012-03-11 Thread Maciek Sokolewicz
On 11 March 2012 02:40, Jesus M. Castagnetto wrote: > 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 Guidel

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 i

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 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 no

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 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. Trying to find something u

[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