Newsgroups: php.doc,php.internals
Path: news.php.net
Xref: news.php.net php.doc:969388403 php.internals:125121
Date: Fri, 23 Aug 2024 11:34:22 +0100 (BST)
To: PHP Documentation List <phpdoc@lists.php.net>, 
    PHP Developers Mailing List <internals@lists.php.net>
Subject: [PHP-DEV] Re: Negatively Voted Notes
In-Reply-To: <f8289b49-e163-ed36-c67b-bb08d1069638@php.net>
Message-ID: <6b47773d-aa48-31a1-6a03-e576c6e43f51@php.net>
References: <f8289b49-e163-ed36-c67b-bb08d1069638@php.net>
Precedence: bulk
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
From: derick@php.net (Derick Rethans)

On Wed, 10 Jul 2024, Derick Rethans wrote:

> We discussed this during one of our foundation meetings, and we propose:
> 
> - to delete all notes with a rating less than -5 that are older than a 
>   year.

As general consensus was that this correct, I will be creating a script 
for this.

One of the other suggestions was to also have a public list to show all 
notes with the highest or lowest rating, and add these to the weekly 
status report (like https://news-web.php.net/php.doc/969388402). I will 
be creating a script for this too.

> - 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.xml)

Hopefully, this is going to get some work behind it soon too.

cheers,
Derick

-- 
https://derickrethans.nl | https://xdebug.org | https://dram.io

Author of Xdebug. Like it? Consider supporting me: https://xdebug.org/support

mastodon: @derickr@phpc.social @xdebug@phpc.social