Release guide for the Perl 6 book
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.
Date Release Manager 2009-10-23 moritz 2009-11-20 PerlJam 2009-12-18 masak 2010-04-06 moritz 2010-06-10 moritz 2010-07-24 pmichaud
Make sure you have the latest changes to the book by executing
in your clone of the book repository.
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
Tag the release:
git tag -a -m'Release YYYY-MM' YYYY-MM git push --tags
YYYY-MMis the four digit year and 2 digit month.
Build the book by typing
make release. This will create a file called build/book-YYYY-MM.pdf where
MMare the current year and month respectively.
Upload the generated file build/book-YYYY-MM.pdf to http://github.com/perl6/book/downloads.
Post the announcement to http://rakudo.org/ (node type story).