Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:124365
Feedback-ID: ia2404087:Fastmail
User-Agent: Cyrus-JMAP/3.11.0-alpha0-568-g843fbadbe-fm-20240701.003-g843fbadb
Precedence: bulk
MIME-Version: 1.0
Message-ID: <75da173d-0f85-40e4-adf5-0c9f4b31b951@app.fastmail.com>
In-Reply-To: <f8289b49-e163-ed36-c67b-bb08d1069638@php.net>
References: <f8289b49-e163-ed36-c67b-bb08d1069638@php.net>
Date: Wed, 10 Jul 2024 11:25:42 -0700
To: "Derick Rethans" <derick@php.net>,
 "PHP Documentation List" <phpdoc@lists.php.net>,
 "PHP Developers Mailing List" <internals@lists.php.net>
Subject: Re: [PHP-DEV] Negatively Voted Notes
Content-Type: text/plain;charset=utf-8
Content-Transfer-Encoding: quoted-printable
From: jimw@trainedmonkey.com ("Jim Winstead")

On Wed, Jul 10, 2024, at 7:18 AM, Derick Rethans wrote:
> We discussed this during one of our foundation meetings, and we propos=
e:
>
> - to delete all notes with a rating less than -5 that are older than a=20
>   year.
> - come up with a plan to crowd source going through the other thousand=
s=20
>   of notes to see if they need to be deleted or integrated into the=20
>   actual text. Each documentation page now has a link to the XML source
>   (such as https://github.com/php/doc-en/blob/master/language/attribut=
es.xml)
>
> Comments?

Yes, please.

The original intent for the notes system was to allow low-effort contrib=
utions from people who would otherwise not learn how to edit DocBook to =
make contributions (and in an era where you couldn't just do easy pull r=
equests on GitHub, but had to send patches to a list or send smoke signa=
ls or something =E2=80=93=C2=A0it was a long time ago).

Notes were never meant to be precious or long-lived, and I don't see any=
 problem with leveraging the voting feature to automatically cull notes =
that have been voted down. Waiting a whole year to eliminate notes with =
a large negative rating is probably longer than necessary.

Jim