diff --git a/content/meta/index.json b/content/meta/index.json index 3266458f8..7d4e470d0 100644 --- a/content/meta/index.json +++ b/content/meta/index.json @@ -7192,5 +7192,12 @@ ], "path_alias.0d0ae5c5-7770-4c7b-970f-aeb17eaee538": [ "node.f9c3fa81-7fb6-42e0-ab93-f62c9e8669cf" + ], + "node.73861efd-5d4e-4c80-8c22-57594ee43dbc": [ + "user.b8966985-d4b2-42a7-a319-2e94ccfbb849", + "node.9b4c39a3-702f-486c-a79b-4d7b96a4f3f6" + ], + "path_alias.5260227a-6421-4bb3-b8dd-daee4ffbdd5a": [ + "node.73861efd-5d4e-4c80-8c22-57594ee43dbc" ] } \ No newline at end of file diff --git a/content/node.73861efd-5d4e-4c80-8c22-57594ee43dbc.yml b/content/node.73861efd-5d4e-4c80-8c22-57594ee43dbc.yml new file mode 100644 index 000000000..5a281b711 --- /dev/null +++ b/content/node.73861efd-5d4e-4c80-8c22-57594ee43dbc.yml @@ -0,0 +1,68 @@ +uuid: + - value: 73861efd-5d4e-4c80-8c22-57594ee43dbc +langcode: + - value: en +type: + - target_id: daily_email + target_type: node_type + target_uuid: 8bde1f2f-eef9-4f2d-ae9c-96921f8193d7 +revision_timestamp: + - value: '2025-08-02T21:56:19+00:00' +revision_uid: + - target_type: user + target_uuid: b8966985-d4b2-42a7-a319-2e94ccfbb849 +revision_log: { } +status: + - value: true +uid: + - target_type: user + target_uuid: b8966985-d4b2-42a7-a319-2e94ccfbb849 +title: + - value: "A CHANGLOG isn't just a list of Git commits" +created: + - value: '2025-08-28T21:53:38+00:00' +changed: + - value: '2025-08-02T21:56:19+00:00' +promote: + - value: false +sticky: + - value: false +default_langcode: + - value: true +revision_translation_affected: + - value: true +path: + - alias: '' + pid: null + langcode: en +body: + - value: |- + Yesterday, I wrote about [keeping a CHANGELOG][0] for software projects, and about the project. + + I like this slogan on their website: + + > Don’t let your friends dump git logs into changelogs. + + A CHANGELOG shouldn't be a list of Git commits in a file. + + It should be in a human-readable format that's easy for people to read and understand, whether they are technical or not. + + This probably isn't the case for the output from `git log`, which may also contain commits like `Refactor` and `wip` that don't mean anything to someone who focused on the higher-level deliverables. + + Git logs are great for Developers, but CHANGELOGs are for everyone. + + [0]: /daily/2025/07/27/do-you-keep-changelog + format: markdown + processed: | +

Yesterday, I wrote about keeping a CHANGELOG for software projects, and about the https://keepachangelog.com project.

+

I like this slogan on their website:

+

Don’t let your friends dump git logs into changelogs.

+
+

A CHANGELOG shouldn't be a list of Git commits in a file.

+

It should be in a human-readable format that's easy for people to read and understand, whether they are technical or not.

+

This probably isn't the case for the output from git log, which may also contain commits like Refactor and wip that don't mean anything to someone who focused on the higher-level deliverables.

+

Git logs are great for Developers, but CHANGELOGs are for everyone.

+ summary: '' +field_daily_email_cta: + - target_type: node + target_uuid: 9b4c39a3-702f-486c-a79b-4d7b96a4f3f6 diff --git a/content/path_alias.5260227a-6421-4bb3-b8dd-daee4ffbdd5a.yml b/content/path_alias.5260227a-6421-4bb3-b8dd-daee4ffbdd5a.yml new file mode 100644 index 000000000..705d5aafb --- /dev/null +++ b/content/path_alias.5260227a-6421-4bb3-b8dd-daee4ffbdd5a.yml @@ -0,0 +1,10 @@ +uuid: + - value: 5260227a-6421-4bb3-b8dd-daee4ffbdd5a +langcode: + - value: en +path: + - value: /node/73861efd-5d4e-4c80-8c22-57594ee43dbc +alias: + - value: /daily/2025/08/28/changlog-isnt-just-list-git-commits +status: + - value: true