import rt 3.8.8
[freeside.git] / rt / HOWTO / release.txt
1 Things to do to release a new version of rt:
2
3         Build and test candidate packages
4
5         Read through the README and src/README.txt files for any updates
6
7         Prepare ChangeLog
8
9                 date -R the latest release
10
11                 should be current if this has been updated as each
12                 change went in.
13
14                 [ Should be automated ]
15
16
17         TODO: nothing below this line is accurate for RT
18
19         END THE BRANCH
20
21                 ae_p rt.2
22                 aede {5}
23                 aerpass {5}
24                 aeib {5}
25                 aeb
26                 aet
27                 aet -reg
28                 aed
29                 aeipass
30
31         START THE NEW BRANCH
32
33                 aenbr -p rt.2 {6}
34                 aenc -p rt.2.{6}
35
36                         Call it something like, "Initialize the new
37                         branch."  Cause = internal_enhancement.  Exempt
38                         it from all tests (*_exempt = true).
39
40                 ae_p rt.2.{6}
41
42                 aedb 100
43
44                 aecd
45
46                 # Change the hard-coded package version numbers
47                 # in the following files.
48                 aecp rttruct debian/changelog rpm/rt.spec
49
50                 vi rttruct debian/changelog rpm/rt.spec
51
52                 # Optionally, do the same in the following:
53                 [optional] aecp HOWTO/change.txt
54                 [optional] aecp HOWTO/release.txt
55                 [optional] aecp debian/rt.postinst
56
57                 [optional] vi HOWTO/change.txt
58                 [optional] vi HOWTO/release.txt
59                 [optional] vi debian/rt.postinst
60
61                 aeb
62
63                 aet -reg
64
65                 aed
66
67                 aede
68
69                 etc.
70
71
72         Read through the FAQ for any updates
73
74         Test downloading from the web site download page
75
76
77         In the Bugs Tracker, add a Group for the new release (0.05)
78
79         Announce to the following mailing lists (template below):
80
81                 rt-announce@lists.fsck.com
82
83
84         Notify www.cmtoday.com/contribute.html
85
86                 [This guy wants an announcement no more frequently than
87                 once a month, so save it for a future release if it's
88                 been too soon since the previous one.]
89
90         Notify freshmeat.net
91
92                 [Wait until the morning so the announcement hits the
93                 main freshmeat.net page while people in the U.S. are
94                 awake and working]
95
96
97
98
99 =======================
100
101 Template release announcement:
102
103
104
105 Version 2.1.XXX of rt has been released and is available for download
106 from the rt web site:
107
108         http://bestpractical.com/rt/
109
110
111
112 WHAT'S NEW IN THIS RELEASE?
113
114 Version 2.1.XXX of rt contains the following important changes:
115
116   - XXX
117
118 For a complete list of changes in version 2.1.XXX, see the CHANGES.txt
119 file in the release itself.
120
121
122 WHAT IS RT? 
123
124         FILL THIS IN