Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:124350
Date: Wed, 10 Jul 2024 15:11:25 +0000
To: Derick Rethans <derick@php.net>
Cc: PHP Documentation List <phpdoc@lists.php.net>, PHP Developers Mailing List <internals@lists.php.net>
Subject: Re: [PHP-DEV] Negatively Voted Notes
Message-ID: <HREE6GbjSP-h63JNvXZoPJE_SNWXyBmcbIm1BlHRduefyMeD9XXlzlz4XGWLvzU-MoJSm7UXjTr849hIYhvg1j_ek7xvCxQKxsyIiUp0f64=@gpb.moe>
In-Reply-To: <f8289b49-e163-ed36-c67b-bb08d1069638@php.net>
References: <f8289b49-e163-ed36-c67b-bb08d1069638@php.net>
Feedback-ID: 96993444:user:proton
Precedence: bulk
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
From: internals@gpb.moe ("Gina P. Banyard")

On Wednesday, 10 July 2024 at 15:18, Derick Rethans <derick@php.net> wrote:

> Hi!
>=20
> There are currently nearly 20000 notes in the documentation, with many
> having a very high negative rating.
>=20
> For example, there are:
>=20
> 1131 notes older than a year, with a rating less than -10
> 2339 notes older than a year, with a rating less than -5
> 5761 notes older than a year, with a rating less than -1
>=20
> The worst offender is:
>=20
> https://www.php.net/manual/en/features.cookies.php#128286 with -159 (not =
sure why the website says -153)
> https://www.php.net/manual/en/language.attributes.overview.php#126887 wit=
h -104
>=20
> We discussed this during one of our foundation meetings, and we propose:
>=20
> - to delete all notes with a rating less than -5 that are older than a
> year.
> - come up with a plan to crowd source going through the other thousands
> of notes to see if they need to be deleted or integrated into the
> actual text. Each documentation page now has a link to the XML source
> (such as https://github.com/php/doc-en/blob/master/language/attributes.xm=
l)
>=20
> Comments?

As one of the primary persons that tries to triage new notes, I am strongly=
 in favour.
Unrelated, it would be very nice if we could improve the spam filters for u=
ser notes somewhat, but this is unrelated to removing unpopular votes.

One question, should this possibly become a monthly cron job that checks fo=
r the user notes and removes those that fall below the above criterias?

Best regards,

Gina P. Banyard