Ability to flag docs comments as outdated or off-topic
| From: | Jamison Bryant | Date: | Fri, 29 May 2026 14:06:31 +0000 |
| Subject: | Ability to flag docs comments as outdated or off-topic | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969388656@lists.php.net to get a copy of this message | ||
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