Differences

This shows you the differences between two versions of the page.

--- mantisbt:release_process [2021/03/05 20:13] – [Bump the version number] dregad
+++ mantisbt:release_process [2024/08/25 05:01] (current) – [Notifications] add Mastodon dregad
@@ Line 86: / Line 86: @@
 ===== Cutting the Release =====
-  * Create an annotated, GPG-signed tag in Git; the tag should be formatted as "release-1.x.x" \\ \\
+  * Create an annotated, GPG-signed tag in Git; the tag should be formatted as ''release-M.N.P'' (e.g. 2.25.4) \\ \\
      * For **stable releases** <code>
-$ git checkout master-1.M.x
+$ git checkout master-M.N
-$ VERSION=1.M.N
+$ VERSION=M.N.P
 $ git tag -s release-$VERSION -m "Stable release $VERSION"
 </code> Note: If this fails, see below for tag signing troubleshooting
     * For **development releases** (e.g. alpha, beta, release candidates) <code>
 $ git checkout master
-$ VERSION=1.M.N
+$ VERSION=M.N.P
 $ git tag -s release-$VERSION -m "Development release $VERSION"
 </code>
@@ Line 102: / Line 102: @@
 </code>
-  * In case we are starting a new stable branch, also create it using the format "master-1.x.x": <code>
+  * In case we are starting a new stable branch, also create it using the format "master-M.N": <code>
-$ git branch master-1.x.x master
+$ git branch master-M.N master
-$ git push origin master-1.x.x
+$ git push origin master-M.N
 </code>
@@ Line 135: / Line 135: @@
 Generate release tarballs using the ''buildrelease-repo.py'' script found in the ''mantisbt-tools.git'' repository:
 <code>
-$ /path/to/buildrelease-repo.py --fresh --docbook --ref release-$VERSION /path/to/output /path/to/repo
+$ /build/buildrelease-repo.py --fresh --docbook --ref release-$VERSION --clean /path/to/output
 </code>
-This will create a //.zip// and //.tar.gz// tarball of the release, and create a //.digest// file for each tarball with //md5// and //sha1// hashes, all in the ''/path/to/output'' directory specified in the command.  The ''--docbook'' option will automatically build single-file versions of the manuals into the tarball's ''/doc'' directory.
+This will create the following files in the ''/path/to/output'' directory specified in the command.
-[dregad] the script also creates '.asc' files, which are not documented in SourceForge section - what to do with them ?
+  * a //.zip// and //.tar.gz// tarball of the release
+  * a //.digest// file for each tarball with //md5// and, //sha*// hashes
+  * an ASCII-armored GPG signature file for each tarball (with //.asc// extension)
+The ''--docbook'' option will automatically build single-file versions of the manuals into the tarball's ''/doc'' directory.
@@ Line 246: / Line 250: @@
 ==== Source Forge ====
-  * Upload the release to [[http://sourceforge.net/projects/mantisbt/files/|SourceForge]] via the File Manager web interface
+  * Upload the release to [[http://sourceforge.net/projects/mantisbt/files/|SourceForge]] <WRAP info>
-  * Release through the SF.net mechanism.
+Put the files in the appropriate directory, based on the release type: Stable releases go to the **mantis-stable**; Alpha, Beta and Release candidates go in **mantis-development**.
-    * The release name should be "1.3.x" (e.g. 1.3.3).
-    * Put the release in the appropriate package based on whether it is a stable or a development release.
+Create a sub-directory for the version, matching it's number e.g. 2.0.0-beta.1, 2.23.0, 2.24.4.
-    * Release candidates, alphas and betas are "development" releases.
+</WRAP>
+    * manually via SourceForge's File Manager web interface, or
+    * with rsync (//USERNAME// is your SourceForge user ID) <code>
+$ rsync -vP --rsh=ssh /path/to/output/* USERNAME@frs.sourceforge.net:/home/frs/project/mantisbt/mantis-stable/$VERSION
+</code>
   * Download the release off SF.net and verify correctness.
-  * Click the "i" next to the files under the folder and do the following actions:
+  * Click the ''(i)'' icon next to the files under the folder and do the following actions:
     * for digests, exclude them from stats.
     * In case of a stable release, make the zip file the default for all platforms.
@@ Line 259: / Line 267: @@
   * Blog: Post an announcement
+  * [[https://matrix.to/#/#mantisbt_mantisbt:gitter.im|Gitter]]: Post an announcement
+  * [[https://phpc.social/@mantisbt|Mastodon]]: Post an announcement
+The notifications below require accounts that only vboctor has access to...
   * Twitter: announce the release via mantisbt twitter account.
   * Update mailing list based on official bug tracker users since users can now signup to our bugtracker to get such announcements.