On Wed, Jul 10, 2024, at 7:18 AM, 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. > - 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?
Yes, please. The original intent for the notes system was to allow low-effort contributions 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 requests on GitHub, but had to send patches to a list or send smoke signals or something – it 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
