Develop a policy for comment deletion on api.drupal.org

Created on 30 June 2015, about 10 years ago
Updated 11 March 2023, over 2 years ago

Time to time D.o webmasters receive requests to delete comments on api.drupal.org. There is no clear policy at the moment in which case it is ok to delete those. The most recent example is the following: #1987054: (comment moderation) Buggy example for hook_menu_alter . It would be helpful if Documentation Working Group would set a policy on what kind of comments should be kept on api.d.o pages and what should be removed.

🌱 Plan
Status

Active

Component

Policies and Procedures

Created by

Live updates comments and jobs are added and updated live.
Sign in to follow issues

Comments & Activities

Not all content is available!

It's likely this issue predates Contrib.social: some issue and comment data are missing.

  • 🇮🇹Italy apaderno Brescia, 🇮🇹
  • 🇺🇸United States TolstoyDotCom L.A.

    Deleting comments would be a huge mistake and would reduce trust. Just add a note if you see something you think is wrong. The person you replied to might point out how you're wrong.

  • 🇮🇹Italy apaderno Brescia, 🇮🇹

    On Stack Exchange sites, they are more restrictive about comments, since they are Q&A sites, while api.drupal.org is a documentation site. They are different type of sites with different necessities.

    On the bottom of any page that documents a class/function/method/constant, there is the following text.

    Buggy or inaccurate documentation? Please file an issue instead of commenting here. Need support? Need help programming? Connect with the Drupal community.

    I would delete comments asking for support and comments pointing out something that is wrong in the documentation, as the comment form already suggests what it should be done instead of posting a comment on api.drupal.org. I would also deleted those Thank you comments, as Stack Exchange sites do.
    I would not delete comments containing example code (including the ones with wrong code), except in the case there are too much comments about that example code (especially when they are old comments). Comments on api.drupal.org have never be supposed to be for extended discussions (which is also true for Stack Exchange comments); if there is an useful discussion about the appropriate code to use, that should go in a more appropriate place, where it gets more visibility (which is useful for Drupal beginner users).

  • 🇮🇹Italy apaderno Brescia, 🇮🇹
  • Status changed to Postponed 9 months ago
  • 🇮🇹Italy apaderno Brescia, 🇮🇹

    Since api.d.o does not allow to log in, and comments from anonymous users are not allowed, this issue can be postponed to when comments will be enabled again (if they will be enabled).

  • 🇮🇹Italy apaderno Brescia, 🇮🇹
  • Status changed to Closed: outdated 26 days ago
  • 🇮🇹Italy apaderno Brescia, 🇮🇹

    I am closing this issue basing on Show comment count across branches on api.drupal.org Needs work : Comments will not be re-enabled on api.drupal.org.

Production build 0.71.5 2024