Standard-version: "Change Log" vs "Changelog"?

Created on 31 Jan 2019  路  10Comments  路  Source: conventional-changelog/standard-version

Hi, I have a question. A CHANGELOG.md file generated by standard-version has a "Change Log" as the first-level heading now. See 猬囷笍

https://github.com/conventional-changelog/standard-version/blob/25300ff44d398cb48889111fb2b55353265a77db/CHANGELOG.md

Which are the words "Change Log" and "Changelog" correct?

For example, Wikipedia says "Changelog", and I see "Changelog" more than "Change Log" (or "Change log") on the internet.

I'm not an English native, so I'm happy if anyone would help this question!

Most helpful comment

Changelog is correct I'm fairly certain. on the https://github.com/olivierlacan/keep-a-changelog/pull/92

See /olivierlacan/keep-a-changelog/

All 10 comments

Good question! I usually see "Changelog" instead of "Change Log". But I'll let native speakers to make a call :)

Changelog is correct I'm fairly certain. on the https://github.com/olivierlacan/keep-a-changelog/pull/92

See /olivierlacan/keep-a-changelog/

Thanks. I would like to change from "Change Log" to "Changelog", but this change may cause a breaking change.

So, I think the following steps to introduce the change:

  1. Add new option to change the 1st level heading text in CHANGELOG.md like this: 猬囷笍
-var header = '# Change Log\n\nAll notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.\n'
+var firstLevelHeading = options.firstLevelHeading || 'Change Log'
+var header = '# ' + firstLevelHeading + '\n\nAll notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.\n'

https://github.com/conventional-changelog/standard-version/blob/aad6a613cfb4f32733ee6b5d7e60ab051e3ba8db/lib/lifecycles/changelog.js#L23

  1. On the next major update, the default heading Change Log will be changed to Changelog.

What do you think about this idea?

If this causes breaking change, I'd say changing it is not necessary since it's a very minor thing

IMHO, this is more of an easy spelling mistake to fix than a breaking change. I welcome having it corrected when I cut a new release of a project. I've submitted a pull request for it.

Spelling has been fixed by @bcoe in #335 - discussion can be closed, i'd say! :)

馃憢 closing, I'll try to have a release out today, as soon as I update all the dependencies with renovate.

Good news! 馃憦 Thanks a lot! 馃槃

@ybiquitous should be fixed in [email protected] try it out.

@bcoe Thanks. When I tried v6, it was so good! 馃槉 馃憤

Was this page helpful?
0 / 5 - 0 ratings