Re: module releasing HOWTO ?

[Christian Rose <menthos menthos com>]

fre 2003-03-14 klockan 05.01 skrev Mark McLoughlin:
>     This is the most time consuming part. First, I do something like:
> 
> <>
> $ cvs -z3 diff -uNp -r GNOME_PANEL_2_3_0 > changes.txt
> <>
> 
>    to generate a list of changes since the last release. Then you
>    should go through each of the ChangeLogs in the diff and come up
>    with a bullet point for each significant change and credit the
>    person(s) who did the work. Some tips:
> 
>      o If several entries relate to the same change only use a single
>        bullet point.
>      o Try to make the bullet points short and snappy but
>        understandable for a general user. That's not always easy.
>      o Generate the list of translations from po/ChangeLog. Note,
>        that the actual translator isn't always the one with who added
>        the ChangeLog entry - try to credit the right person/team. The
>        format is "$locale($translator)". Sort alphabetically by
>        locale.

Probably a good thing to remember is that we use UTF-8 in the
ChangeLogs, so that every contributor can have umlauts and other
diacritics in their names spelled correctly. So it's probably a good
idea to also make the release mail encoded in UTF-8, in order to not
have the names munged in that step (like with "Joël" in the cited
example).

Thanks to everyone for giving credit to translators in your release
mails by the way -- nothing beats the feeling of seeing one's own name
and getting appreciation that way, and I guess most people will agree.


Thanks,
Christian