Closed (works as designed)
Project:
Drupal core
Version:
9.5.x-dev
Component:
documentation
Priority:
Normal
Category:
Task
Assigned:
Unassigned
Reporter:
Created:
16 Jun 2020 at 17:59 UTC
Updated:
14 Apr 2023 at 13:02 UTC
Jump to comment: Most recent
Comments
Comment #2
cilefen commentedWhich specific release notes are you referring-to that is missing the statement? These files do change sometimes. I think .htaccess changed in 8.9.0.
#3092563: Avoid overwriting .htaccess changes during scaffolding > security problem
Comment #3
jakerogers commentedPerhaps a better question is "why not include some unique identifier within these files (maybe vs# akin to Modules), which will allow user to easily and quickly distinguish these critical files which need updating?"
Comment #8
xjmIt is already a standard practice to highlight such changes at the very top of the release update information, under the header "Changes to site-owner managed files". For example:
https://www.drupal.org/project/drupal/releases/9.4.0#site-owner-managed
If no such changes are included, the section will be absent. Sometimes, on security releases only, we include this text for clarity:
If you encounter a change to one of these files that you did not expect, be sure to read previous release notes. For example, if you are updating from Drupal 9.4.4 to the latest release, you need to account for all the release notes in between as well, including the changes to these files in Drupal 9.4.7.
Otherwise, missing information in the release notes can be reported as a bug in the core queue or raised as an issue in Drupal Slack.
In checking previous releases I noticed the formatting is inconsistent sometimes. We'll try to be more consistent in the future. Thanks for your feedback!
Marking "Works as designed" since this is already standard policy. Individual mistakes or missing info should be filed as bugs. Thanks!