When using the link
Add new comment on any of the Community Documentation pages on Drupal.org, a message is shown near the top that looks like so:
Is your comment an addition, problem report, or example? Instead of adding a comment, edit the page content directly. If you are unsure of the correct edits, add a comment here and then edit the page to update the page status. Once a solution for the page has been agreed upon, edit the page accordingly and read incorporating comments on how to remove the related comment(s).
Is your comment a question or request for support? Take it to the forums. Questions are not answered here, and comments not providing useful information may be removed at any time.
If you wonder why that message is there, then go have a look at the comments below various community pages, such as the "Read documentation" links mentioned (within "Resources") on the project page from these contributed modules:
- From the top 10 of reported installs:
- Random picks:
- ... (there are a lot of them, including on some of their child pages as in this example).
Obviously, those comments don't comply with what's mentioned on Commenting on community documentation pages and API pages, i.e.:
... if you have a question about how to use a function or perform a task being described, please use the Forums or one of the other Support options, rather than adding a comment. And if you want to report a software bug, file an issue instead of adding a comment somewhere.
So what can people, who contribute to a contributed module's documentation via such Community pages, do to:
- discourage the creation of such comments?
- cleanup such comments?
Note: I'm aware that there are modules (also in the top 10 of reported installs) that have a "Read Documentation"-link on their project page that is not somewhere on drupal.org, but that's not what my question is about (I don't want to consider links outside drupal.org).