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 <[email protected]> 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: @[email protected] @[email protected]
>