Re: Negatively Voted Notes

In a prior life I used to take an hour a week looking at "best notes" and the "bottom rated notes" on master and integrate/delete them: https://main.php.net/manage/user-notes.php?view=notes&type=3 https://main.php.net/manage/user-notes.php?view=notes&type=4 Maybe we could make the "best notes" list publicly available with the goal of soliciting old/existing/new doc writers getting their feet wet by inlining good notes? I think it makes sense to automatically delete notes that have been downvoted for a while, and I think the proposed threshold makes sense. -Hannes On Wed, Jul 10, 2024 at 7:18 AM Derick Rethans <derick@php.net> wrote: > Hi! > > There are currently nearly 20000 notes in the documentation, with many > having a very high negative rating. > > For example, there are: > > 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 > > The worst offender is: > > 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 > with -104 > > 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. > - 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) > > Comments? > > 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 >