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
- 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 whereYYYY
andMM
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).
Hey! The above document had some coding errors, which are explained below:
- Around line 36:
-
Expected text after =item, not a number
- Around line 50:
-
Expected text after =item, not a number
- Around line 59:
-
Expected text after =item, not a number
- Around line 65:
-
Expected text after =item, not a number
- Around line 70:
-
Expected text after =item, not a number