Re: Notes Status, 24899 total

From: Date: Mon, 17 Aug 2020 16:00:33 +0000
Subject: Re: Notes Status, 24899 total
References: 1 2 3 4 5 6 7 8  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969387589@lists.php.net to get a copy of this message
On 17.08.2020 at 17:05, Larry Garfield wrote: > On Sat, Aug 15, 2020, at 3:10 PM, Derick Rethans wrote: > >> On 15 August 2020 21:02:28 BST, Larry Garfield <larry@garfieldtech.com> wrote: >> >>> I'm flexible on what that is; I just want to avoid deleting things too >>> aggressively and getting yelled at. >> >> I used to be quite aggressive deleting the ones in the DateTime pages. >> Everything that was code, a "this is how to use it", I would delete. >> The idea behind notes is to improve the documentation. So notes either >> need to be incorporated or deleted. > > So it sounds like the consensus is "improving the doc page so that comments are redundant, > and then purging redundant or off-topic comments with extreme prejudice" is an OK thing to do, > and should be encouraged, even if we've been slacking on it badly. Yes? More or less; I don't mind keeping a feew user nots which may not be relevant enough for the manual proper, but might still be helpful. See also <http://doc.php.net/tutorial/user-notes.php>. -- Christoph M. Becker

« previous php.doc (#969387589) next »