This is the first time I've done a run of helping with the CHANGELOG.txt/release notes prepping, and it seems like at least one useful modification would be to include issue #s alongside CHANGELOG.txt entries so we can very easily make something that looks like this: https://www.drupal.org/project/drupal/releases/8.2.0-beta2 out of it.

Support from Acquia helps fund testing for Drupal Acquia logo

Comments

webchick created an issue. See original summary.

webchick’s picture

Status: Active » Needs review
Related issues: +#2846830: Add changelog for Drupal 8.3.0
FileSize
4.1 KB

For example. (Only did the first bit to get a taste.)

webchick’s picture

Oops. :)

xjm’s picture

Hm, my preference would be not to do this. It makes the notes harder to read. If we're going to automate things, I'd rather do it the other way around: have people actually tag things for the release notes, add the human-readable summary *handwave* generated into the release notes, and then have it added to the changelog without links/IDs. The release notes are not formatted the way they are because it's desired; they're formatted the way they are because they are auto-generated from the issue tag & a bash script for most releases:.

xjm’s picture

So @webchick convinced me this will in fact save a lot of manual work.

xjm’s picture

+++ b/core/CHANGELOG.txt
@@ -1,3 +1,72 @@
+  * #2779647: Added the Workflows module (experimental) which abstracts the

Maybe we should put the issue ID at the end in parentheses. That's still parseable, but it puts the emphasis on the human information. Unlike in the git log, the NID is not the most important info.

wturrell’s picture

Revised patch with names at end in parentheses (and # removed, feels superfluous).

Opinions:
- like having the issue numbers, find bit too distracting at start
- pedantry: many redundant words in descriptions, could write more concisely if desired. (If so, presume best wait for this to be merged given expected git conflicts with 2846830.)

xjm’s picture

Status: Needs review » Postponed
Issue tags: -8.3.0 release notes +8.4.0 release notes

@webchick and I agreed to do this for the 8.4.0 CHANGELOG, but not for 8.3.0. :) Postponing for that reason. Thanks!

xjm’s picture

Status: Postponed » Closed (duplicate)
Issue tags: -8.4.0 release notes