Standard-version: Add switch to include commit body

[derekgreer]

Currently standard-version only includes the commit header. Is there a way to optionally include the commit body in the CHANGELOG.md? Is there a sister tool I should be using to generate release notes to end users that provide all the details?

[ffxsam]

@derekgreer Interesting no one noticed this, it's a great idea. When we squash our PRs on GitHub, it puts the squashed commits into the body, e.g.:

commit c18e83e1c45644ef7c81adae7fa7ed4581292b25
Author: Person
Date:   Wed Mar 20 16:46:13 2019 -0500

    feat(Downloads): Download modal improvements (#87)

    * fix: Some fix

    * fix: Updated things

    * fix: Did another thing

It would be cool if that body could be put into the changelog as an indented list underneath the main commit message.

[ffxsam]

@bcoe @stevemao Thoughts on this?

[willvincent]

Even just having extra detail beyond the first line, other than _only_ breaking changes would be useful. Whether that's a list of commits in a PR being merged in, or descriptive text added manually as part of the commit message.

Some new features, or involved fixes may warrant additional description above and beyond the one line. Suggesting "you can manually edit the changelog" as has been mentioned in other issues, to my mind, kind of largely defeats the purpose of using an automated tool... if the info is _already in_ the commit, it should be able to be pulled out of the commit log and injected into the change log. Especially if changelogs aren't being generated immediately every time there's a PR merge, or whatever.. having to then go back and manually add some description to the generated file, sometime in the future, is not very reasonable.

[bcoe]

see motivation for a more flexible preset: https://github.com/conventional-changelog/conventional-changelog/pull/421

[stevemao]

Maybe, we can use <details> tag for commit body?

[bcoe]

@stevemao this seems clever 😄 (in the good sense of the word). I might still be inclined to make it a config option that gets turned on.

[joshtoper]

Was any progress made on this? This tool is fab but I require the full commit message in the Changelog, rather than just the header.

@stevemao Can you elaborate on what you meant re the <details> tag please?

[stevemao]

@joshtoper see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/details
I was just throwing random idea.

[polaroidkidd]

I'm really in favour of this idea. I've done away with the develop branch in my projects as I tend to work myself from feature/issue to feature/issue and publish asap. Having the commit body included in the changelog would be very helpful in providing some context to the changelog.

[Feiyang1]

Any progress or plan on supporting this? I'm also very interested in being able to customize changelog generation, as I may want to only include a section of the commit body in the changelog.

[crutchcorn]

This would be extremely helpful for many of my projects. I'd love to be able to outline a majority of the changes in my CHANGELOG by using a commit body without ejecting:

https://github.com/crutchcorn/react-native-button-toggle-group/commit/9b79bc6bbf5a2055af890336faec6defab1b58b0

[willvincent]

@crutchcorn Perfect use case scenario.

[crutchcorn]

I'm going to be looking into adding this functionality. Linking related issues:

https://github.com/conventional-changelog/conventional-changelog/issues/338

https://github.com/conventional-changelog/conventional-changelog/issues/423

[bcoe]

@crutchcorn I've been slammed with various other projects recently, but would appreciate the patch 👍

this chat can potentially be a good place to coordinate.

[patrickmichalina]

@crutchcorn do you intend to make a simple option to enable this feature instead of needing to create a customized template?

[crutchcorn]

@patrickmichalina I plan on making it a simple toggle.

I've been reading through the source code of the dependencies and have an idea of how to add to this, but it's kinda down my priority list. I'll try taking a stab throughout the week or two, but it might take me a bit to get through

[Oloremo]

Looking forward to this feature as well

[derekgreer]

Any updates?

[mheunem]

I've some changes: https://github.com/conventional-changelog/standard-version/pull/675
In my implementation, you can define own templates to show a body per commit message.