Hello,
···
I had an idea to improve the docs that I was discussing with Larry Garfield and he suggested I bring it to this list.
Something I think could benefit the PHP docs is the ability for users to mark comments as out-of-date or off-topic, when they have clearly gone stale or contain erroneous info.
Here is a concrete example, see the top comment on this page:
https://www.php.net/manual/en/function.curl-multi-init.php
The most-upvoted comment contains this link: http://arguments.callee.info/2010/02/21/multiple-curl-requests-with-php/ which is a DEAD link. Also, all of the comments on that page are nearly a decade old, with the youngest being posted 8 years ago.
The upvote system alone doesn’t fully solve this kind of issue. With so few comments on the page, even if the broken-link comment were voted to the bottom, it would still be visible and still mislead readers. A “flag as outdated” or “flag as off-topic” mechanism would give the community a lightweight way to surface stale comments for maintainer review.
Warm regards,
Jamison