7 ms·
This isn't a changelog, this is a NEWS or release-notes file. Keeping a changelog in version control is an invitation for artificial conflicts on every single
by JoshTriplett 8y ago
This isn't a changelog, this is a NEWS or release-notes file.
Keeping a changelog in version control is an invitation for artificial conflicts on every single commit. (There are ways around that, but better to not keep a traditional changelog, since version control does completely make those obsolete.)
But keeping a NEWS file is an excellent practice. And when you send out a release announcement, you can include the corresponding release notes for that release.
- exegete 8y agoYeah, that's the GNU coding standard. Changelog is for developers and bug hunters to see changes to the source. Version control probably takes the place of that now. NEWS is for "user-visible changes worth mentioning". https://www.gnu.org/prep/standards/html_node/Documentation.html#Documentation https://www.gnu.org/prep/standards/html_node/Documentation.h...
- JoshTriplett 8y agoMany people and projects now use NEWS that don't have anything to do with that particular coding standard.
- bostonvaulter2 8y agoPeople generally use those independently now. The meaning of the english word is changing.