Ability to flag docs comments as outdated or off-topic

From: 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

« previous php.doc (#969388656) next »