Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 305 lines (207 sloc) 9.111 kb
f45384a Patrick R. Michaud First version of release_guide.pod, based on a proposed version
pmichaud authored
1 =head1 release_guide.pod - guide to Rakudo releases
2
3 Rakudo's development release cycle is based on Parrot's release
4 cycle. Parrot releases the third Tuesday of each month; Rakudo
5 will generally issue its own development release two days after
6 the Parrot release.
7
8 Each development release is given a sequential number and a
9 code name based on an active Perl Mongers group. Rakudo's
10 February 2009 release is #14; prior releases were bundled as
11 part of monthly Parrot releases.
12
13 =head2 Development releases
14
5b477c0 Patrick R. Michaud Note the release manager for each of the previous releases,
pmichaud authored
15 2009-02-26 Rakudo #14 "Vienna" (pmichaud)
16 2009-03-20 Rakudo #15 "Oslo" (pmichaud)
17 2009-04-23 Rakudo #16 "Bratislava" (pmichaud)
18 2009-05-21 Rakudo #17 "Stockholm" (pmichaud)
19 2009-06-18 Rakudo #18 "Pittsburgh" (pmichaud)
20 2009-07-23 Rakudo #19 "Chicago" (moritz)
cf27952 [docs] bare bones 2009-08 announcement and release_guide update
Kyle Hasselbacher authored
21 2009-08-20 Rakudo #20 "PDX" (kyle)
e33d20e Moritz Lenz [docs] mention smolder reports in release_guide.pod
moritz authored
22 2009-09-17 Rakudo #21 "Seattle" (particle)
37956bf Jonathan Scott Duff Updates in preparation for release
perlpilot authored
23 2009-10-22 Rakudo #22 "Thousand Oaks" (duff)
f5065b6 Carl Mäsak [docs/release_guide.pod] rolled releases forward
masak authored
24 2009-11-19 Rakudo #23 "Lisbon" (masak)
7f1c3fe chromatic [docs] Updated release guide.
chromatic authored
25 2009-12-17 Rakudo #24 "Seoul" (chromatic)
4da4e4d Patrick R. Michaud Update release dates and names.
pmichaud authored
26 2010-01-22 Rakudo #25 "Minneapolis" (pmichaud)
37e5746 Patrick R. Michaud Update release_guide.pod with recent release information.
pmichaud authored
27 2010-02-18 Rakudo #26 "Amsterdam" (mberends)
fc30fad Moritz Lenz [docs] the Copenhagen release has already happend; colomon++ voluntueere...
moritz authored
28 2010-03-18 Rakudo #27 "Copenhagen" (smash)
05ee824 Moritz Lenz [docs] update release guide
moritz authored
29 2010-04-22 Rakudo #28 "Moscow" (moritz)
296a56c Solomon Foster Add #29 Erlangen to the release list, and mark that [Coke] has the July ...
colomon authored
30 2010-05-20 Rakudo #29 "Erlangen" (colomon)
cbff7d0 Carl Mäsak [docs/release_guide.pod] updates and improvements
masak authored
31 2010-06-17 Rakudo #30 "Kiev" (masak)
5c33c5a Will Coleda This release is heading out the door soon.
coke authored
32 2010-07-22 Rakudo #31 "Atlanta" (Coke)
99a4e24 Matthew Walton Update release guide with 2010.08 release.
mathw authored
33 2010-08-19 Rakudo #32 "Pisa" (mathw)
74a156f Moritz Lenz [release] name is Milan. Bump VERSION
moritz authored
34 2010-09-23 Rakudo #33 "Milan" (moritz)
33bdcee Jonathan Scott Duff release preparation
perlpilot authored
35 2010-10-21 Rakudo #34 "Paris" (duff)
03e6f5a Carl Mäsak [docs/release_guide.pod] slight tweaks
masak authored
36 2010-11-18 Rakudo #35 "Melbourne" (masak)
4830af6 Nuno Carvalho [release] update release guide
nunorc authored
37 2010-12-23 Rakudo #36 "New York" (smash)
a7d5f19 Tadeusz Sośnierz Added announcement for 2011.01
tadzik authored
38 2011-01-20 Rakudo #37 "BristolBath" (tadzik)
c25afe6 Arne Skjærholt [release] Add announcement, updated release guide. Added own name and
arnsholt authored
39 2011-02-17 Rakudo #38 "Toulouse" (arnsholt)
e70f27d Jeff Horelick [release] Add announcement, update release gude and add myself to
jdhore authored
40 2011-03-17 Rakudo #39 "Orlando" (jdhore)
1624491 Moritz Lenz copy release_guide.pod changes from master, renumber for missed 2011.08 ...
moritz authored
41 2011-04-21 Rakudo #40 "ZA" (duff)
42 2011-05-19 Rakudo #41 "Dahut" (jdhore)
43 2011-06-23 Rakudo #42 "Bruxelles" (jdhore)
44 2011-07-21 Rakudo #43 "Beijing" (mberends,moritz)
45 2011-08-18 -- none --
01d3a6b Jonathan Scott Duff Update release info
perlpilot authored
46 2011-09-30 Rakudo #44 "Riga" (tadzik)
e17c139 Jonathan Scott Duff Choose a release name
perlpilot authored
47 2011-10-20 Rakudo #45 "Houston" (duff)
617fef9 Tadeusz Sośnierz Add a new release announcement, update release_guide
tadzik authored
48 2011-11-17 Rakudo #46 "London" (tadzik)
dfd1d7a Moritz Lenz update release guide
moritz authored
49 2011-12-22 Rakudo #47 "Columbus" (moritz)
f45384a Patrick R. Michaud First version of release_guide.pod, based on a proposed version
pmichaud authored
50
dfd1d7a Moritz Lenz update release guide
moritz authored
51 =head2 Planned 2012 releases
f45384a Patrick R. Michaud First version of release_guide.pod, based on a proposed version
pmichaud authored
52
53 Dates are based on Parrot's expected release schedule.
54
dfd1d7a Moritz Lenz update release guide
moritz authored
55 2012-01-19 #48
56 2012-02-23 #49
57 2012-03-22 #50
58 2012-04-19 #51
59 2012-05-17 #52
60 2012-06-21 #53
f45384a Patrick R. Michaud First version of release_guide.pod, based on a proposed version
pmichaud authored
61
381d26e Patrick R. Michaud Updates to docs/announce and docs/release_guide.pod .
pmichaud authored
62 =head2 Suggested .pm group names for future releases
63
1624491 Moritz Lenz copy release_guide.pod changes from master, renumber for missed 2011.08 ...
moritz authored
64 MadMongers (YAPC::NA 2012)
65 Brazos Valley (YAPC::NA 2007, p6 hackathon)
66 Toronto (YAPC::NA 2005, p6 hackathon)
381d26e Patrick R. Michaud Updates to docs/announce and docs/release_guide.pod .
pmichaud authored
67
1d49284 Jonathan Scott Duff [docs] Add tentative release dates through the end of 2010
perlpilot authored
68 More names can be gotten from L<http://www.pm.org> if you
69 can't think of one with any particular significance to Perl
03e6f5a Carl Mäsak [docs/release_guide.pod] slight tweaks
masak authored
70 6 or Rakudo.
1d49284 Jonathan Scott Duff [docs] Add tentative release dates through the end of 2010
perlpilot authored
71
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
72 =head2 Steps to create a release (for release managers)
73
74 Each Rakudo development release is timed to occur two
01ae3fa Moritz Lenz [docs] propose ThousandOaks as a release name, in recognition of their c...
moritz authored
75 days after a Parrot monthly release.
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
76
77 =over 4
78
79 =item 1.
80
03e6f5a Carl Mäsak [docs/release_guide.pod] slight tweaks
masak authored
81 A few days before the Parrot release, it's a good idea to...
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
82
83 =over 4
84
85 =item *
86
87 Remind people of the upcoming release, invite people to
01ae3fa Moritz Lenz [docs] propose ThousandOaks as a release name, in recognition of their c...
moritz authored
88 update the ChangeLog file, update the ROADMAP, choose a
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
89 release name, etc.
90
91 =item *
92
93 Verify that the Parrot trunk head is able to build Rakudo
e33d20e Moritz Lenz [docs] mention smolder reports in release_guide.pod
moritz authored
94 and run the spectest suite. Also check the smolder reports
0d3c66e Moritz Lenz [docs] update release guide
moritz authored
95 at L<http://smolder.parrot.org/app/projects/smoke_reports/5>.
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
96
97 =item *
98
99 If Parrot's trunk exhibits any problems building or running
100 Rakudo (that require changes to Parrot to fix), immediately
101 report them to the Parrot development team so they can be
102 fixed prior to Parrot's release.
103
104 =item *
105
106 Review the RT queue for tickets that might need resolving
cf27952 [docs] bare bones 2009-08 announcement and release_guide update
Kyle Hasselbacher authored
107 prior to the release, addressing them as needed. "Tickets
108 that need resolving" is left your discretion. Any problem
109 that has a large impact on users is worth addressing either
110 as a fix or as prominent documentation (the README and/or
111 the release announcement).
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
112
113 =back
114
115 =item 2.
116
59332ae Jonathan Scott Duff update release guide
perlpilot authored
117 Once Parrot issues its monthly release, tag NQP for release
118 according to the year and month of the release:
119
120 $ git clone https://github.com/perl6/nqp.git
121 $ cd nqp
122
123 Follow the steps in NQP's F<docs/release_guide.pod>.
e0bfb29 Moritz Lenz [build] git_describe is enough, no need for a separate version specifica...
moritz authored
124
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
125 =item 3.
126
01ae3fa Moritz Lenz [docs] propose ThousandOaks as a release name, in recognition of their c...
moritz authored
127 The short period following the Parrot release until the
128 Rakudo release is generally intended for fixing bugs,
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
129 updating documentation, and so on.
130
1624491 Moritz Lenz copy release_guide.pod changes from master, renumber for missed 2011.08 ...
moritz authored
131 =item 4.
f3eb64f [release_guide] Added instructions for updating the leap-second tables.
Kodi Arfer authored
132
133 Update Rakudo's leap-second tables:
134
135 $ perl tools/update-tai-utc.pl src/core/tai-utc.pm
136
137 If a new leap second has been announced, F<tai-utc.pm> will be modified, so
138 commit the new version:
139
140 $ git commit src/core/tai-utc.pm
141
142 But probably there won't be any new leap seconds, in which case the file
143 will be unchanged.
144
1624491 Moritz Lenz copy release_guide.pod changes from master, renumber for missed 2011.08 ...
moritz authored
145 =item 5.
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
146
147 As the actual release date nears, review the git log history
148 to see if any additional items need to be added to the ChangeLog.
149 This can be conveniently done with "git log --since=yyyy-mm-dd --reverse".
150
48c1791 Patrick R. Michaud More release_guide.pod improvements.
pmichaud authored
151 $ git commit docs/ChangeLog
152
1624491 Moritz Lenz copy release_guide.pod changes from master, renumber for missed 2011.08 ...
moritz authored
153 =item 6.
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
154
155 When it's time to cut the release, create a new release announcement
9be7890 Patrick R. Michaud Update release guide to note that we now use dots instead of hyphens
pmichaud authored
156 in docs/announce/YYYY.MM. It's often a good idea to use the
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
157 previous month's file as a starting point for this. Highlight areas
158 in which the new release is significant. If possible, also give
159 some small details about the choice of release name. (If the
160 details are a bit lengthy, this can often best be done as a separate
161 section at the bottom of the announcement.)
162
082caee Moritz Lenz [docs] instruct release manager to include a list of contributors in the...
moritz authored
163 Include a list of contributors since the last release in the announcement.
164 You can get an automatically generated list by running
165
cbff7d0 Carl Mäsak [docs/release_guide.pod] updates and improvements
masak authored
166 $ perl tools/contributors.pl
082caee Moritz Lenz [docs] instruct release manager to include a list of contributors in the...
moritz authored
167
ecc4efa Jonathan Scott Duff minor modifications
perlpilot authored
168 B<Note>: this program requires the perl module L<Date::Simple> be installed.
169
082caee Moritz Lenz [docs] instruct release manager to include a list of contributors in the...
moritz authored
170 Please check the result manually for duplicates and other errors.
171
9be7890 Patrick R. Michaud Update release guide to note that we now use dots instead of hyphens
pmichaud authored
172 $ git add docs/announce/YYYY.MM
48c1791 Patrick R. Michaud More release_guide.pod improvements.
pmichaud authored
173 $ git commit docs
174
1624491 Moritz Lenz copy release_guide.pod changes from master, renumber for missed 2011.08 ...
moritz authored
175 =item 7.
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
176
177 Update the release dates and names at the top of this file
4c248e5 Carl Mäsak [docs/release_guide.pod] s/-/_/ in file name
masak authored
178 (F<docs/release_guide.pod>). Also improve these instructions if
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
179 you find any steps that are missing.
180
4c248e5 Carl Mäsak [docs/release_guide.pod] s/-/_/ in file name
masak authored
181 $ git commit docs/release_guide.pod
48c1791 Patrick R. Michaud More release_guide.pod improvements.
pmichaud authored
182
1624491 Moritz Lenz copy release_guide.pod changes from master, renumber for missed 2011.08 ...
moritz authored
183 =item 8.
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
184
185 Make sure everything compiles and runs from a known clean state:
186
187 $ make realclean
188 $ perl Configure.pl --gen-parrot
189 $ make
190 $ make test
a63c7e0 Moritz Lenz add stresstest target, and move day 17 of the advent tests to stresstest
moritz authored
191 $ make stresstest
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
192
674c984 Jonathan Scott Duff [release] update release_guide
perlpilot authored
193 There are many tests to run for the stresstest target. If
194 you have a machine with multiple CPU cores, you may want to
195 execute that last as
196
197 $ TEST_JOBS=4 make stresstest
198
199 where 4 is the number of CPU cores. This should make the
200 total time to execute all of the tests dramatically less.
201
202 Continue adjusting things until make stresstest passes as expected.
3c7289b Patrick R. Michaud Small improvement to guidelines for failing spectests at time of release...
pmichaud authored
203 Often this means fixing a bug, fudging a test, or (temporarily?)
0d3c66e Moritz Lenz [docs] update release guide
moritz authored
204 commenting out a test file in t/spectest.data . Use your best
3c7289b Patrick R. Michaud Small improvement to guidelines for failing spectests at time of release...
pmichaud authored
205 judgment or ask others if uncertain what to do here.
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
206
1624491 Moritz Lenz copy release_guide.pod changes from master, renumber for missed 2011.08 ...
moritz authored
207 =item 9.
0d3c66e Moritz Lenz [docs] update release guide
moritz authored
208
9cbe751 Moritz Lenz update release guide to include tagging of NQP
moritz authored
209 =over 4
210
211 =item *
212
213 Go to the NQP repository, tag it and push the tags
214
215 $ git tag -a -m"tag release YYYY.MM" YYYY.MM # e.g., 2010.02
216
217 Check the NQP revision
218
219 $ git describe # should come out as YYYY.MM
220 # if not, contact your local git vendor or #perl6
221
222 If you got the same version back as you entered, proceed with
223
224 $ git push --tags
225
226 =item *
227
228 Go back to the Rakudo repository, and update the NQP dependency:
229
230 $ echo YYYY.MM > tools/build/NQP_REVISION
231 $ git commit -m '[release] bump NQP revision' tools/build/NQP_REVISION
232
233 =item *
234
0d3c66e Moritz Lenz [docs] update release guide
moritz authored
235 Enter the new version into the F<VERSION> file, and commit the changes:
236
237 $ echo 2010.09 > VERSION
238 $ git commit -m '[release] bump VERSION' VERSION
239
9cbe751 Moritz Lenz update release guide to include tagging of NQP
moritz authored
240 =back
241
1624491 Moritz Lenz copy release_guide.pod changes from master, renumber for missed 2011.08 ...
moritz authored
242 =item 10.
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
243
244 Make sure any locally modified files have been pushed back to github.
245
48c1791 Patrick R. Michaud More release_guide.pod improvements.
pmichaud authored
246 $ git status
247 $ git push
248
1624491 Moritz Lenz copy release_guide.pod changes from master, renumber for missed 2011.08 ...
moritz authored
249 =item 11.
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
250
cbff7d0 Carl Mäsak [docs/release_guide.pod] updates and improvements
masak authored
251 Create a tarball by entering C<make release VERSION=YYYY.MM>,
240e2f0 Nuno Carvalho Testing commit.
nunorc authored
252 where YYYY.MM is the month for which the release is being made.
f83304d Moritz Lenz [docs] markup fix
moritz authored
253 This will create a tarball file named C<rakudo-YYYY.MM.tar.gz>.
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
254
ecc4efa Jonathan Scott Duff minor modifications
perlpilot authored
255 B<Caution>: this step removes any untracked files in F<t/spec>.
0d3c66e Moritz Lenz [docs] update release guide
moritz authored
256 So please make a backup if you have any important data in there.
e3fe329 Moritz Lenz [docs] warn about potential damage from "make release"
moritz authored
257
1624491 Moritz Lenz copy release_guide.pod changes from master, renumber for missed 2011.08 ...
moritz authored
258 =item 12.
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
259
260 Unpack the tar file into another area, and test that it
ecc4efa Jonathan Scott Duff minor modifications
perlpilot authored
261 builds and runs properly using the same process in step 7.
262 If there are any problems, fix them and go back to step 7.
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
263
1624491 Moritz Lenz copy release_guide.pod changes from master, renumber for missed 2011.08 ...
moritz authored
264 =item 13.
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
265
1624491 Moritz Lenz copy release_guide.pod changes from master, renumber for missed 2011.08 ...
moritz authored
266 Tag the release by its release month ("YYYY.MM") and its code name.
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
267
1624491 Moritz Lenz copy release_guide.pod changes from master, renumber for missed 2011.08 ...
moritz authored
268 $ git tag -a -m"tag release #nn" YYYY.MM # e.g., 2010.02
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
269 $ git tag -a -m"tag release #nn" CODENAME # e.g., "Bratislava"
79d0b9a Patrick R. Michaud Fix "git push --tags" in docs/release_guide.pod .
pmichaud authored
270 $ git push --tags
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
271
1624491 Moritz Lenz copy release_guide.pod changes from master, renumber for missed 2011.08 ...
moritz authored
272 =item 14.
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
273
274 Upload the release tarball to github's download area at
01ae3fa Moritz Lenz [docs] propose ThousandOaks as a release name, in recognition of their c...
moritz authored
275 L<http://github.com/rakudo/rakudo/downloads>.
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
276
1624491 Moritz Lenz copy release_guide.pod changes from master, renumber for missed 2011.08 ...
moritz authored
277 =item 15.
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
278
ecc4efa Jonathan Scott Duff minor modifications
perlpilot authored
279 To avoid public confusion with Rakudo Star releases, we now publish
ded33e1 Patrick R. Michaud Update release guide to note new publication strategy for
pmichaud authored
280 compiler release announcements ONLY to perl6-compiler@perl.org.
281 (We may restart widespread announcements of compiler releases
282 once they are known, or we may begin publishing a single
283 announcement for both.)
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
284
1624491 Moritz Lenz copy release_guide.pod changes from master, renumber for missed 2011.08 ...
moritz authored
285 =item 16.
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
286
ecc4efa Jonathan Scott Duff minor modifications
perlpilot authored
287 Update the Wikipedia entry at L<http://en.wikipedia.org/wiki/Rakudo>.
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
288
1624491 Moritz Lenz copy release_guide.pod changes from master, renumber for missed 2011.08 ...
moritz authored
289 =item 17.
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
290
291 You're done! Celebrate with the appropriate amount of fun.
292
293 =back
381d26e Patrick R. Michaud Updates to docs/announce and docs/release_guide.pod .
pmichaud authored
294
f45384a Patrick R. Michaud First version of release_guide.pod, based on a proposed version
pmichaud authored
295 =head1 COPYRIGHT
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
296
fe2b4e1 Moritz Lenz [docs] update years in release_guide.pod, jdhore++. Also add the rest of...
moritz authored
297 Copyright (C) 2009-2011, The Perl Foundation.
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
298
f45384a Patrick R. Michaud First version of release_guide.pod, based on a proposed version
pmichaud authored
299 =cut
2f3a8ab Patrick R. Michaud Update docs/release_guide.pod with typical steps for cutting a release.
pmichaud authored
300
f45384a Patrick R. Michaud First version of release_guide.pod, based on a proposed version
pmichaud authored
301 # Local Variables:
302 # fill-column: 100
303 # End:
304 # vim: expandtab shiftwidth=4:
Something went wrong with that request. Please try again.