On 06/15/2011 09:11 AM, R.I.Pienaar wrote:
Below is a edit taking your 66 line changelog down to a usable 25 lines
by removing all the purely testing related lines, the merge lines and maint
lines.
I think this is already a huge improvement. Changelogs are what users use
to determine the suitability of a upgrade so we should write them with that
in mind.
I agree with this.
I also think formatting is important - make sure the descriptions of
each change all line up so it is easy to scan quickly. In fact, I'd even
go as far as putting the description at the start of the line and
relegating the commit hash and issue# to the end of the line (I
generally don't need to know those).
Oh, and I prefer plain-text mail. :)
R.
--
You received this message because you are subscribed to the Google Groups "Puppet
Developers" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/puppet-dev?hl=en.
