Re: Notes Status, 24899 total
| From: | Larry Garfield | Date: | Mon, 17 Aug 2020 15:05:35 +0000 |
| Subject: | Re: Notes Status, 24899 total | ||
| References: | 1 2 3 4 5 6 7 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969387585@lists.php.net to get a copy of this message | ||
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.
> >
> >--Larry Garfield
>
> 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.
>
> cheers,
> Derick
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?
--Larry Garfield