I'm a noob with git and i would like to know the best practice to create tags and generate/mantain a changelog.
Until now, i always created a readme.md and manually indicate (in the section "changelog") the most important feature
- changed layout in home
- added slideshow in gallery
There is no some common guidelines yet. But A lot of good rules explained on keepachangelog.
And as they mention:
Dumping a diff of commit logs. Just don’t do that, you’re helping nobody.
And I'm fully agree with it.
Thats why I create Github Changelog Generator that generates Changelog according all these guidelines.
Actually it works with GitHub only, but it present a good example, how change log should look like.
It automatically generate change log from your tags, issues, labels and pull requests.
For example: This changelog was generated by this script: CHANGELOG.md