changing the changelog
hi plasma people! :) we're working on so many different things and often very much "heads down" in work that the changelog is getting neglected. we're also beyond the early "OMG, this feature will take 2 months and 100s of commits to be fully done, so i can't use commit log msgs to build the changelog" phase of plasmadom. it is now, i believe, realistic to use commit msgs to build our changelog. i'd like to therefore request that all commits to plasma code in kdelibs, kdebase and kdeplasma-addons that represent a new feature or a bug fix include the appropriate keywords in the commit msg. kmail will filter them for me :) features should have FEATURE in the message. bugs should have either a BUG:# comment or just BUG or BUGFIX in the msg. thanks :) -- Aaron J. Seigo humru othro a kohnu se GPG Fingerprint: 8B8B 2209 0C6F 7C47 B1EA EE75 D6B7 2EB1 A7F1 DB43 KDE core developer sponsored by Qt Development Frameworks signature.asc Description: This is a digitally signed message part. ___ Plasma-devel mailing list Plasma-devel@kde.org https://mail.kde.org/mailman/listinfo/plasma-devel
Re: changing the changelog
On Thursday, August 12, 2010, Aaron J. Seigo wrote: > features should have FEATURE in the message. > > bugs should have either a > BUG:# comment or just BUG or BUGFIX in the msg. erf.. and IMPROVEMENT for notable improvements that aren't bugfixes or features. -- Aaron J. Seigo humru othro a kohnu se GPG Fingerprint: 8B8B 2209 0C6F 7C47 B1EA EE75 D6B7 2EB1 A7F1 DB43 KDE core developer sponsored by Qt Development Frameworks signature.asc Description: This is a digitally signed message part. ___ Plasma-devel mailing list Plasma-devel@kde.org https://mail.kde.org/mailman/listinfo/plasma-devel
Re: changing the changelog
On Thu, Aug 12, 2010 at 2:48 PM, Aaron J. Seigo wrote: > i'd like to therefore request that all commits to plasma code in kdelibs, > kdebase and kdeplasma-addons that represent a new feature or a bug fix > include the appropriate keywords in the commit msg. kmail will filter them > for me :) This will also help when we migrate to git: using "git shortlog" or "git log --pretty=oneline" it will be much easier to generate the Changelogs :). So, it's *really* important that we write nice "first line message" and then a nice commit message for each commit :) It will help the maintainer's life a lot :D Cheers, ___ Plasma-devel mailing list Plasma-devel@kde.org https://mail.kde.org/mailman/listinfo/plasma-devel
Re: changing the changelog
On Thursday 12 August 2010 19:06:21 Artur Souza (MoRpHeUz) wrote: > On Thu, Aug 12, 2010 at 2:48 PM, Aaron J. Seigo wrote: > > i'd like to therefore request that all commits to plasma code in kdelibs, > > kdebase and kdeplasma-addons that represent a new feature or a bug fix > > include the appropriate keywords in the commit msg. kmail will filter > > them for me :) > > This will also help when we migrate to git: using "git shortlog" or > "git log --pretty=oneline" it will be much easier to generate the > Changelogs :). > > So, it's *really* important that we write nice "first line message" > and then a nice commit message for each commit :) It will help the > maintainer's life a lot :D > > Cheers, One of the things I really like about git is how easy it is to set up a commit message template that could include all the keywords as a memory aid (1). I've tried a quick google but there doesn't seem to be an easy way to do this using subversion? John. (1) For the Nokia/Qt template see http://qt.gitorious.org/qt/qt/blobs/4.7/.commit-template ___ Plasma-devel mailing list Plasma-devel@kde.org https://mail.kde.org/mailman/listinfo/plasma-devel
Re: changing the changelog
On Thu, Aug 12, 2010 at 4:21 PM, John Layt wrote: > One of the things I really like about git is how easy it is to set up a > commit message template that could include all the keywords as a memory aid +1. As soon as we move to git I can create such a template for us :) Not that it's hard, just that someone needs to step up and as I'm already talking too much on this thread I can do that :P Cheers, ___ Plasma-devel mailing list Plasma-devel@kde.org https://mail.kde.org/mailman/listinfo/plasma-devel
Re: changing the changelog
On Thursday 12 August 2010, Aaron J. Seigo wrote: > hi plasma people! :) > > we're working on so many different things and often very much "heads down" > in work that the changelog is getting neglected. we're also beyond the > early "OMG, this feature will take 2 months and 100s of commits to be > fully done, so i can't use commit log msgs to build the changelog" phase > of plasmadom. it is now, i believe, realistic to use commit msgs to build > our changelog. > > i'd like to therefore request that all commits to plasma code in kdelibs, > kdebase and kdeplasma-addons that represent a new feature or a bug fix > include the appropriate keywords in the commit msg. kmail will filter them > for me :) > > features should have FEATURE in the message. > +1, since some feature already got in before i started using the FEATURE keyword, i've added them to a CHANGELOG-4.6 in the design folder. if someboby can think about of something important he committed and did not use the keyword, please fill it here before the memory fades away Cheers, Marco Martin ___ Plasma-devel mailing list Plasma-devel@kde.org https://mail.kde.org/mailman/listinfo/plasma-devel