release-guide.pod

NAME

Release guide for the Perl 6 book

SCHEDULE

We'll release monthly, and (conjectural) release three days after each parrot release, so the Friday after the 3rd Tuesday of each month.

We want a good version printed for the Rakudo * release, which implies that we should finalize in mid March 2010.

DATES

Date            Release Manager
2009-10-23      moritz
2009-11-20      PerlJam
2009-12-18      masak
2010-04-06      moritz
2010-06-10      moritz

RELEASE PROCEDURE

0

Make sure you have the latest changes to the book by executing

git pull

in your clone of the book repository.

1

Summarize the major changes since the last release and put them in an announcement. Place the announcement in docs/announce/.

Use the following command to see a chronology of changes:

git log --since=YYYY-MM-DD --reverse 

When you're done, commit the announcement and push it to the repo:

git commit docs/announce/YYYY-MM
git push

2

Tag the release:

git tag -a -m'Release YYYY-MM' YYYY-MM
git push --tags

where YYYY-MM is the four digit year and 2 digit month.

3

Build the book by typing make release. This will create a file called build/book-YYYY-MM.pdf where YYYY and MM are the current year and month respectively.

4

Upload the generated file build/book-YYYY-MM.pdf to http://github.com/perl6/book/downloads.

5

Post the announcement to http://rakudo.org/ (node type story).

POD ERRORS

Hey! The above document had some coding errors, which are explained below:

Around line 35:

Expected text after =item, not a number

Around line 49:

Expected text after =item, not a number

Around line 58:

Expected text after =item, not a number

Around line 64:

Expected text after =item, not a number

Around line 69:

Expected text after =item, not a number