Revert the changes done in the ae8a19d98bffd244fac1ce280e059c83a9366c46 commit

Created on 28 June 2024, 10 months ago
Updated 14 July 2024, 9 months ago

Commit ae8a19d98bffd244fac1ce280e059c83a9366c46 did the following changes.

  • It removed the documentation comment containing the @defgroup tag
  • It removed the long description used for hook_file_download()
  • It created a README.md file with what the content of those documentation comments

Those changes are not correct because the content of those comments is the source for the documentation pages shown on https://api.drupal.org/api/examples, including that page which the front page for this project.

Those changes go in the opposite direction taken when it has been decided to include the Examples for Developers project on api.drupal.org.
Moving the content of those comments in a README.md file does not help developers for the same reason removing all the documentation comments from Drupal core and creating README.md files to replace those documentation comments would not help developers. api.drupal.org helps much in understanding how Drupal works, at the point the API module code has been rewritten for Drupal 10.

Those changes must be reverted.

📌 Task
Status

Fixed

Version

4.0

Component

File Example

Created by

🇮🇹Italy apaderno Brescia, 🇮🇹

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

Merge Requests

Comments & Activities

Production build 0.71.5 2024