Differences between revisions 1 and 27 (spanning 26 versions)
Revision 1 as of 2012-02-29 12:08:47
Size: 1991
Comment: workflow to create and send announcements
Revision 27 as of 2016-10-03 19:08:04
Size: 3933
Editor: LauraArjona
Comment: add micronews
Deletions are marked like this. Additions are marked like this.
Line 5: Line 5:
1. Start to write the draft using the template provided in the [[https://alioth.debian.org/scm/browser.php?group_id=100480|publicity subversion repository]] under publicity/announcements/en/template.wml: it contains all the necessary wml tags 1. Start to write the draft using the [[https://anonscm.debian.org/cgit/publicity/announcements.git/tree/en/template.wml|template]] provided in the [[https://anonscm.debian.org/cgit/publicity/announcements.git|publicity announcements git repository]] under en/template.wml: it contains all the necessary wml tags
Line 7: Line 7:
2. add your draft to the repository (all DDs have rw access to it) in publicity/announcement/en/$year/ with this namescheme: YYYY-MM-DD-$title.wml (where YYYY-MM-DD is the expected release date, if you've not decided it yet, just add the file under publicity/announcement/en/drafts/ with a simple title as name). 2. add your draft to the repository (all DDs have rw access to it) in en/$year/ with this namescheme: YYYY-MM-DD-$title.wml (where YYYY-MM-DD is the expected release date, if you've not decided it yet, just add the file under en/drafts/ with a simple title as name).
Line 11: Line 11:
4. '''Press and/or webmasters only!''' on $expected-release-date publish the announcement in the website: you just need to add it to the webwml CVS repository at webwml/english/News/$year with the namescheme YYYYMMDD.wml). Take care also of all the available translations (usually are just french, spanish and german) commiting also them on the appropriate dirs. 4. '''Press and/or webmasters only!''' on $expected-release-date publish the announcement in the website: you just need to add it to the webwml CVS repository at webwml/english/News/$year with the namescheme YYYYMMDD.wml). Take care also of all the available translations (usually are just french, spanish and german) commiting also them on the appropriate dirs. Here is a hacky shell loop for moving the files. You will need to adjust the announcement name and also the path to webwml on your system.

{{{
#FIXME: read parameters
#FIXME: create missing Makefiles
ann=2015/20150606.wml ; year=2015 ; date=20150606 ; webwml=/home/user/path/to/webwml ; for code in $(ls */$ann | cut -d/ -f 2) ; do lang=$(grep -l LANG=$code $webwml/*/.wmlrc | sed 's/.*webwml.//;s_/.*__') ; mkdir -p $webwml/$lang/News/$year/ ; mv $code/$ann $webwml/$lang/News/$year/$date.wml ; done ; echo These announcements remain: $(ls */$ann)
}}}

4.1 '''Press and/or webmasters only!''' For stable/oldstable point releases, {{{english/releases/}}}''codename''/{{{errata.wml}}} and {{{english/template/debian/release_info.wml}}} need to be updated with the version number of the point release.

In the release_info.wml files there are 3 tags to be updated: current_release_* , current_release_date_* and current-cd-release; the 3 of them should wait until the the CD images are ready. You can go on with this workflow safely, and come back here when the CD images are ready to update these 3 tags.
Line 15: Line 25:
   ssh wolkenstein.debian.org
  
sudo -u debwww -i
   cd
/srv/www.debian.org/
   ./
update-part News
   ssh -tt wolkenstein.debian.org sudo -u debwww /srv/www.debian.org/update-part News
Line 21: Line 28:
6. now you're ready for creating the mail: the script to create it is the publicity repo under publicity/en/announcements/scripts/DNhtml2mail.pl Please note that for new Debian releases the whole website needs rebuilding.

6. now you're ready for creating the mail: the script to create it is the publicity dpn repo under scripts/DPNhtml2mail.pl
Line 24: Line 33:
7. yay! you can finally send the mail to debian-announce@lists.debian.org (if you have the super-powers to do it) or ask Tolimar, !MadameZou, pabs or taffit to do it for you! {{{
./scripts/DPNhtml2mail.pl -t news -i $year/$date
}}}

7. yay! you can finally send the mail to debian-news@lists.debian.org or debian-announce@lists.debian.org plus other relevant recipients/lists, if needed (e.g. debian-lts-announce or debconf list). The publicity delegates will moderate your mail you have no permissions to write to that list! As a reminder, -news should be the default place to send things. -announce is reserved for special announcements, such as new point releases etc.

8. Follow the instructions in https://micronews.debian.org/pages/contribute.html to send a microblogging that will be mirrored in identi.ca/debian and other social networks.

9. Remove the announcement from the [[https://anonscm.debian.org/cgit/publicity/announcements.git|publicity announcements git repository]] once it has been published.

10. Finally, you might want to update the debian-timeline if this event is noteworthy.

Workflow for the Publicity/Press announcement

This page describe the current workflow and best practices for the creation and release of announcements.

1. Start to write the draft using the template provided in the publicity announcements git repository under en/template.wml: it contains all the necessary wml tags

2. add your draft to the repository (all DDs have rw access to it) in en/$year/ with this namescheme: YYYY-MM-DD-$title.wml (where YYYY-MM-DD is the expected release date, if you've not decided it yet, just add the file under en/drafts/ with a simple title as name).

3. at least 2 days before the expected release date, send a mail to debian-publicity@lists.debian.org (adding in CC debian-l10n-english@lists.debian.org and debian-i18n@lists.debian.org) asking for reviews and translations

4. Press and/or webmasters only! on $expected-release-date publish the announcement in the website: you just need to add it to the webwml CVS repository at webwml/english/News/$year with the namescheme YYYYMMDD.wml). Take care also of all the available translations (usually are just french, spanish and german) commiting also them on the appropriate dirs. Here is a hacky shell loop for moving the files. You will need to adjust the announcement name and also the path to webwml on your system.

#FIXME: read parameters
#FIXME: create missing Makefiles
ann=2015/20150606.wml ; year=2015 ; date=20150606 ; webwml=/home/user/path/to/webwml ; for code in $(ls */$ann | cut -d/ -f 2) ; do lang=$(grep -l LANG=$code $webwml/*/.wmlrc | sed 's/.*webwml.//;s_/.*__') ; mkdir -p $webwml/$lang/News/$year/ ; mv $code/$ann $webwml/$lang/News/$year/$date.wml ; done ; echo These announcements remain: $(ls */$ann)

4.1 Press and/or webmasters only! For stable/oldstable point releases, english/releases/codename/errata.wml and english/template/debian/release_info.wml need to be updated with the version number of the point release.

In the release_info.wml files there are 3 tags to be updated: current_release_* , current_release_date_* and current-cd-release; the 3 of them should wait until the the CD images are ready. You can go on with this workflow safely, and come back here when the CD images are ready to update these 3 tags.

5. Press and/or webmasters only! run a partial rebuild of the website:

   ssh -tt wolkenstein.debian.org sudo -u debwww /srv/www.debian.org/update-part News

Please note that for new Debian releases the whole website needs rebuilding.

6. now you're ready for creating the mail: the script to create it is the publicity dpn repo under scripts/DPNhtml2mail.pl Please note that the script is not perfect: a check and a couple of adjustments by hand are usually required (and a patch to improve it, as well!)

./scripts/DPNhtml2mail.pl -t news -i $year/$date

7. yay! you can finally send the mail to debian-news@lists.debian.org or debian-announce@lists.debian.org plus other relevant recipients/lists, if needed (e.g. debian-lts-announce or debconf list). The publicity delegates will moderate your mail you have no permissions to write to that list! As a reminder, -news should be the default place to send things. -announce is reserved for special announcements, such as new point releases etc.

8. Follow the instructions in https://micronews.debian.org/pages/contribute.html to send a microblogging that will be mirrored in identi.ca/debian and other social networks.

9. Remove the announcement from the publicity announcements git repository once it has been published.

10. Finally, you might want to update the debian-timeline if this event is noteworthy.