Missing legacy comments on Drupal 7.X API docs

Created on 21 May 2024, about 1 month ago
Updated 27 June 2024, about 14 hours ago

API page: https://api.drupal.org/api/drupal/modules!node!node.pages.inc/function/n...

Enter a descriptive title (above), then describe the problem you have found:

As noted by the title, I discovered today that there are no longer any legacy comments on Drupal 7.X API documentation. As you know, there are still a very large amount of organizations that still use Drupal 7. To lose the historical context of these comments is a large detriment to institutions/companies that still rely on it.

Can you please revert that change in your database to include those comments? Example:

https://web.archive.org/web/20210506192654/https://api.drupal.org/api/dr...

Thank you for your consideration.
Juan

๐Ÿ“Œ Task
Status

Active

Version

2.0

Component
Documentationย  โ†’

Last updated about 2 hours ago

No maintainer
Created by

๐Ÿ‡บ๐Ÿ‡ธUnited States juangong

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

Comments & Activities

  • Issue created by @juangong
  • ๐Ÿ‡บ๐Ÿ‡ธUnited States cilefen
  • ๐Ÿ‡ช๐Ÿ‡ธSpain fjgarlin

    Moving to the correct project, as the "API" module per-se supports comments and there is no issue with that.

    Comments are turned off in the new site, and were also turned off / disabled months ago in the previous Drupal 7 site, before we migrated the site to the new version.

  • ๐Ÿ‡บ๐Ÿ‡ธUnited States juangong

    Can you please allow for the display of those old comments to still exist? Even if comments are now disabled? They have seriously important historical context that developers still try to look for every day, for a better example:

    https://web.archive.org/web/20240120062612/https://api.drupal.org/api/dr...

    Having these no longer searchable seems like a detriment to Drupal.

  • ๐Ÿ‡บ๐Ÿ‡ธUnited States drumm NY, US

    ๐Ÿ› Classes missing from Drupal 10 Fixed has more context about the recent upgrade, comments were removed mid-March.

    The ability to log in and make new comments is not planned to come back. While we could restore the comments for the Drupal 7 documentation, that would be temporary. As soon as a Drupal core API changes enough that API moduleโ€™s comment integration needs updating for compatibility, we plan to drop that instead. This is not functionality that has not had an active maintainer, and removing commenting greatly simplifies the site.

  • ๐Ÿ‡บ๐Ÿ‡ธUnited States markabur

    I found this issue because I miss those comments too. I maintain several D7 sites and up until the comments were removed, I still referred to pages such as l() for its valuable examples in the comments.

    https://web.archive.org/web/20210507000325/https://api.drupal.org/api/dr...

    Without comments or examples, the API page is no better than the source code that I already have on my machine.

    It's a shame that we need to rely on archive.org now for docs for what is still the most popular version of Drupal.

Production build 0.69.0 2024