1282 |
25 Jan 11 |
nicklas |
1 |
=================================================== |
1282 |
25 Jan 11 |
nicklas |
Release procedure for the Reggie extension package |
1282 |
25 Jan 11 |
nicklas |
3 |
=================================================== |
1282 |
25 Jan 11 |
nicklas |
4 |
|
1282 |
25 Jan 11 |
nicklas |
Follow these instructions to release version A.B of |
1282 |
25 Jan 11 |
nicklas |
this package. Please update the instructions if you |
1282 |
25 Jan 11 |
nicklas |
find anything that is not correct or missing. |
1282 |
25 Jan 11 |
nicklas |
8 |
|
1282 |
25 Jan 11 |
nicklas |
1. Make sure that all changes have been committed to |
1282 |
25 Jan 11 |
nicklas |
the trunk. Check with other developers if not |
1282 |
25 Jan 11 |
nicklas |
sure. |
1282 |
25 Jan 11 |
nicklas |
12 |
|
1463 |
14 Nov 11 |
martin |
2. Update the version numbers. |
1282 |
25 Jan 11 |
nicklas |
14 |
|
1282 |
25 Jan 11 |
nicklas |
In build.xml: |
1282 |
25 Jan 11 |
nicklas |
<property name="version" value="A.B" /> |
4185 |
28 Oct 16 |
nicklas |
<property name="delivery.version" value="..." /> |
1463 |
14 Nov 11 |
martin |
<property name="depend.base-version" value="..." /> |
4185 |
28 Oct 16 |
nicklas |
19 |
|
4185 |
28 Oct 16 |
nicklas |
The `delivery.version` property should only be changed if |
4185 |
28 Oct 16 |
nicklas |
the delivery client has been updated. |
4185 |
28 Oct 16 |
nicklas |
22 |
|
1282 |
25 Jan 11 |
nicklas |
Run `ant update-version`. This should put the version |
1282 |
25 Jan 11 |
nicklas |
numbers in a lot of files, including, |
1282 |
25 Jan 11 |
nicklas |
META-INF/extensions.xml. |
1282 |
25 Jan 11 |
nicklas |
26 |
|
1282 |
25 Jan 11 |
nicklas |
Check (and update if needed) the README file and |
1282 |
25 Jan 11 |
nicklas |
and the wiki pages (see also step 8 and 9 below): |
1282 |
25 Jan 11 |
nicklas |
29 |
|
6309 |
11 Jun 21 |
nicklas |
https://baseplugins.thep.lu.se/wiki/net.sf.basedb.reggie |
6309 |
11 Jun 21 |
nicklas |
https://baseplugins.thep.lu.se/wiki/PluginDownload |
1282 |
25 Jan 11 |
nicklas |
32 |
|
2736 |
06 Oct 14 |
nicklas |
3. Make sure that debug flags in javascript files have been reset. |
2736 |
06 Oct 14 |
nicklas |
Eg. search all *.js files for 'var debug' and check that it doesn't |
2736 |
06 Oct 14 |
nicklas |
say 'var debug = 1', 'var debug = true' or something similar. |
2736 |
06 Oct 14 |
nicklas |
36 |
|
2736 |
06 Oct 14 |
nicklas |
4. Make sure that the code compiles and can be packaged. |
1282 |
25 Jan 11 |
nicklas |
38 |
|
1282 |
25 Jan 11 |
nicklas |
ant package |
1282 |
25 Jan 11 |
nicklas |
40 |
|
1282 |
25 Jan 11 |
nicklas |
will create the file 'reggie-A.B.tar.gz' in |
1282 |
25 Jan 11 |
nicklas |
the project directory. |
1282 |
25 Jan 11 |
nicklas |
43 |
|
2736 |
06 Oct 14 |
nicklas |
5. Make sure that the installation of Reggie works |
1282 |
25 Jan 11 |
nicklas |
and that the installation instructions are up to date. |
1282 |
25 Jan 11 |
nicklas |
46 |
|
2736 |
06 Oct 14 |
nicklas |
6. When everything is OK, commit any changes to subversion. |
1282 |
25 Jan 11 |
nicklas |
48 |
|
2736 |
06 Oct 14 |
nicklas |
7. Create a tag in subversion: |
1282 |
25 Jan 11 |
nicklas |
50 |
|
6309 |
11 Jun 21 |
nicklas |
svn copy https://baseplugins.thep.lu.se/svn/extensions/net.sf.basedb.reggie/trunk \ |
6309 |
11 Jun 21 |
nicklas |
https://baseplugins.thep.lu.se/svn/extensions/net.sf.basedb.reggie/tags/A.B \ |
1282 |
25 Jan 11 |
nicklas |
-m "Tagging release A.B" |
1282 |
25 Jan 11 |
nicklas |
54 |
|
3383 |
10 Jun 15 |
nicklas |
8. Check out the tagged version in a new directory and create the release |
3383 |
10 Jun 15 |
nicklas |
package. NOTE! Do not use the package from step 4 since it may contain |
3383 |
10 Jun 15 |
nicklas |
non-versioned files from the regular working copy. |
3383 |
10 Jun 15 |
nicklas |
58 |
|
3383 |
10 Jun 15 |
nicklas |
ant package |
3383 |
10 Jun 15 |
nicklas |
60 |
|
3383 |
10 Jun 15 |
nicklas |
Upload the packaged release as an attachment to: |
6309 |
11 Jun 21 |
nicklas |
https://baseplugins.thep.lu.se/wiki/net.sf.basedb.reggie |
1282 |
25 Jan 11 |
nicklas |
63 |
|
6309 |
11 Jun 21 |
nicklas |
9. Edit the https://baseplugins.thep.lu.se/wiki/net.sf.basedb.examples.reggie |
1282 |
25 Jan 11 |
nicklas |
page: |
1282 |
25 Jan 11 |
nicklas |
66 |
|
1282 |
25 Jan 11 |
nicklas |
* Add a new entry to the Download table |
1282 |
25 Jan 11 |
nicklas |
* Change the README link to point to the tagged release. Use |
1282 |
25 Jan 11 |
nicklas |
the following wiki code: |
1282 |
25 Jan 11 |
nicklas |
[source:/extensions/net.sf.basedb.reggie/tags/A.B/README README] |
1282 |
25 Jan 11 |
nicklas |
* Check the information on the download page |
6309 |
11 Jun 21 |
nicklas |
https://baseplugins.thep.lu.se/wiki/PluginDownload |
1282 |
25 Jan 11 |
nicklas |
and make sure it is correct |
1282 |
25 Jan 11 |
nicklas |
74 |
|
2736 |
06 Oct 14 |
nicklas |
10. Create a new milestone: 'Reggie vA.B+1' |
1282 |
25 Jan 11 |
nicklas |
76 |
|
2736 |
06 Oct 14 |
nicklas |
11. Close the 'Reggie vA.B' milestone. Move |
1282 |
25 Jan 11 |
nicklas |
any remaining tickets to the newly create milestone. |
1282 |
25 Jan 11 |
nicklas |
79 |
|
2736 |
06 Oct 14 |
nicklas |
12. Update the version numbers. |
1282 |
25 Jan 11 |
nicklas |
81 |
|
1357 |
28 Apr 11 |
nicklas |
In build.xml: <property name="version" value="A.(B+1)-dev" /> |
1282 |
25 Jan 11 |
nicklas |
Run `ant update-version` and commit the changes to |
1282 |
25 Jan 11 |
nicklas |
subversion: |
1282 |
25 Jan 11 |
nicklas |
85 |
|
1282 |
25 Jan 11 |
nicklas |
svn commit -m "Preparing for future release A.B+1" |
6801 |
11 Aug 22 |
nicklas |
87 |
|
6801 |
11 Aug 22 |
nicklas |
13. If the release was a bug-fix release (eg. Reggie vA.B.x) |
6801 |
11 Aug 22 |
nicklas |
do not forget to merge the changes to the trunk. |