-
Notifications
You must be signed in to change notification settings - Fork 141
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Start recording changes in a change log #650
Comments
There's also Pocketmine's styled changelog which is a more structured approach to keepachangelog |
I wouldn't wait to start doing it. Better get into the habit of doing it now so that you have a good grip on how best to do it when you have more users. Besides, having a changelog will help promote growth in the first place, since people will be more empowered to develop against alpha versions if there's a changelog to give them a TL;DR of each version rather than them having to dig through the code themselves. |
Can the changelog be generated automatically? |
This one looks promising.... https://github.com/ldez/gcg |
Changelogs are NOT commit logs, changelog should be a handcrafted log only containing what's useful to end user/developer, but keeps all the pointless noise out.
So please don't use git commits as changelog, they defeats the point of having a changelog in the first place. With that out of the way, it could be possible to generate changelogs, based on something, to produce a usable changelog that does not defeat the point of having a changelog in the first place, but in my opinion that will put more burden on contributors and maintainers on keeping some sort of machine readable commit for the changelog generator. It would been easier if the changelog isn't coupled that deeply into the system affecting everyone else. |
As discussed on Discord, we think it's a good idea to track changes per version in a change log. I'm personally a fan of Go's release note structure, but something like keepachangelog suggests a simpler changelog which is also an option. Feel free to suggest your ideas and preferences below.
As for when we start doing this, right now there is only 1 production user of Dragonfly, so maintaining change logs is probably not worth it yet. Once we get more users though, this is something to look into.
Until then, please post any suggestions below.
The text was updated successfully, but these errors were encountered: