support bang syntax for breaking changes

[wyardley]

I know it's not in the original Angular spec, but https://www.conventionalcommits.org/en/v1.0.0/ does outline the bang syntax (feat!) for breaking changes. As best I've been able to tell, that's still not supported here. Would that need to be added in conventional-changelog or one of its subrepos? Is it possible to configure?

Maybe some additional context:
conventional-changelog/commitlint#658

[travi]

semantic-release uses the angular convention by default, which does not support the syntax you mention. you can choose the conventional-commits convention instead, which supports that syntax. we intend to make that the default convention at some point, but for now you have to switch your convention in your config.

[wyardley]

Got it. I thought it was using conventional as the default. Thanks for the response.

[wyardley]

I have this in the release config:

plugins:
  - '@semantic-release/commit-analyzer'

which uses conventional-changelog -- I had assumed that the various projects under conventional-changelog followed the conventional commits standard by default, though I can see now that it is referring to different conventional commit formats. It's very hard to search for examples because of all of the similar / related names.

After reading through the docs a few times, I did figure it out; to put it here in case anyone else is searching:

% npm install --save-dev conventional-changelog-conventionalcommits

and then

plugins:
  - - '@semantic-release/commit-analyzer'
    - preset: conventionalcommits

[djcsdy]

It's also necessary to configure release-notes-generator, otherwise changes marked with ! won't be included in the release notes.

Also, don't fall into the trap of specifying only the presets that you're configuring. If you specify presets, then the default list of presets is overwritten by whatever you specify.

So if you want the default semantic-release configuration but with Conventional Commits, the full configuration is:

plugins:
  - - '@semantic-release/commit-analyzer'
    - preset: conventionalcommits
  - - '@semantic-release/release-notes-generator'
    - preset: conventionalcommits
  - '@semantic-release/npm'
  - '@semantic-release/github'

and:

npm install --save-dev conventional-changelog-conventionalcommits

It's almost impossible to figure this out from the docs, it took me a lot of trial and error.

[wyardley]

Thanks @djcsdy
Yes, and I probably want it for @semantic-release/changelog as well.