Release management: Difference between revisions
Jump to navigation
Jump to search
(12 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
[[Category:Project management]] | [[Category:Project management]] | ||
[[Category:Development]] | |||
=Release management= | =Release management= | ||
Line 23: | Line 24: | ||
# Finish Changelog | # Finish Changelog | ||
# Finish PR spiel for the mailing list and wiki/website. | # Finish PR spiel for the mailing list and wiki/website. | ||
# Email to all Scribus translators [https://wiki.scribus.net/canvas/Release_management#Release_Day_-_2_weeks see Release t-2 weeks] that the deadline for their translations is about to pass | |||
==Release Day - 2 days== | ==Release Day - 2 days== | ||
==Release Day - 1 day== | ==Release Day - 1 day== | ||
* Commit a new splash and about screen image, and update all versions in a number of source code locations: | * Commit a new splash and about screen image, and update all versions in a number of source code locations: | ||
:* <code>Scribus/scribus/ui/about.cpp</code> | |||
:* <code>Scribus/scribus.lsm</code> | :* <code>Scribus/scribus.lsm</code> | ||
:* <code>Scribus/config.h.cmake</code> | :* <code>Scribus/config.h.cmake</code> | ||
Line 36: | Line 39: | ||
:* <code>Scribus/OSX-package/inputs/Scribus.pkg-Info.plist</code> | :* <code>Scribus/OSX-package/inputs/Scribus.pkg-Info.plist</code> | ||
:* <code>Scribus/Changelog</code> | :* <code>Scribus/Changelog</code> | ||
:* <code>Scribus/win32/ | :* <code>Scribus/win32/msvc2013/scribus-main/Scribus.rc</code> | ||
:* <code>Scribus/win32/ | :* <code>Scribus/win32/msvc2013/win-config.h</code> | ||
:* <code>Scribus/win32/msvc2015/scribus-main/Scribus.rc</code> | |||
:* <code>Scribus/win32/msvc2015/win-config.h</code> | |||
:* Prepare a packager's release tarball and alert the packagers. | :* Prepare a packager's release tarball and alert the packagers. | ||
* Tag the new release | * Tag the new release | ||
Line 43: | Line 48: | ||
:: OR | :: OR | ||
:* <code>svn copy svn+ssh://[url]/svn/trunk svn+ssh://[url]/svn/tags/Release_a.b.c[.rcN] -m "Tag a.b.c[.rcN]"</code> | :* <code>svn copy svn+ssh://[url]/svn/trunk svn+ssh://[url]/svn/tags/Release_a.b.c[.rcN] -m "Tag a.b.c[.rcN]"</code> | ||
==Release Day== | ==Release Day== | ||
===Before Release=== | ===Before Release=== | ||
Line 58: | Line 64: | ||
<li>Run the tar process - we need this file for all of the compression types we want so we do this first:</li> | <li>Run the tar process - we need this file for all of the compression types we want so we do this first:</li> | ||
: <code>tar -cvf scribus-X.Y.Z.tar scribus-X.Y.Z/</code> | : <code>tar --exclude=.svn -cvf scribus-X.Y.Z.tar scribus-X.Y.Z/</code> | ||
<li>Compress the files:</li> | <li>Compress the files:</li> | ||
:XZ: <code>xz -k -e -v -z scribus-X.Y.Z.tar</code> | :XZ: <code>xz -k -e -v -z scribus-X.Y.Z.tar</code> | ||
:7Zip: <code>7z a scribus-X.Y.Z | :7Zip: <code>7z a -xr'!.*' scribus-X.Y.Z.7z scribus-X.Y.Z/</code> | ||
:BZ2: <code>bzip2 -k scribus-X.Y.Z.tar | :BZ2: <code>bzip2 -k scribus-X.Y.Z.tar</code> | ||
:GZ: <code>gzip -c scribus-X.Y.Z.tar > scribus-X.Y.Z.tar.gz</code> | :GZ: <code>gzip -c scribus-X.Y.Z.tar > scribus-X.Y.Z.tar.gz</code> | ||
<li>GPG Sign the files:</li> | <li>GPG Sign the files:</li> | ||
:<code>gpg --default-key <key> --sign --detach-sign --armor scribus-X.Y.Z | :<code>gpg --default-key <key> --sign --detach-sign --armor scribus-X.Y.Z.7z</code> | ||
:<code>gpg --default-key <key> --sign --detach-sign --armor scribus-X.Y.Z.tar.gz </code> | :<code>gpg --default-key <key> --sign --detach-sign --armor scribus-X.Y.Z.tar.gz </code> | ||
:<code>gpg --default-key <key> --sign --detach-sign --armor scribus-X.Y.Z.tar.xz </code> | :<code>gpg --default-key <key> --sign --detach-sign --armor scribus-X.Y.Z.tar.xz </code> | ||
Line 73: | Line 79: | ||
<li>Verify the files:</li> | <li>Verify the files:</li> | ||
:<code>gpg --verify scribus-X.Y.Z | :<code>gpg --verify scribus-X.Y.Z.7z.asc scribus-X.Y.Z.7z</code> | ||
:<code>gpg --verify scribus-X.Y.Z.tar.bz2.asc scribus-X.Y.Z.tar.bz2</code> | :<code>gpg --verify scribus-X.Y.Z.tar.bz2.asc scribus-X.Y.Z.tar.bz2</code> | ||
:<code>gpg --verify scribus-X.Y.Z.tar.gz.asc scribus-X.Y.Z.tar.gz</code> | :<code>gpg --verify scribus-X.Y.Z.tar.gz.asc scribus-X.Y.Z.tar.gz</code> | ||
Line 94: | Line 100: | ||
====Translations==== | ====Translations==== | ||
# Pull Translations from Transifex using the script --pull option (which will pull all Transifex maintained languages) | # Pull Translations from Transifex using the [https://raw.githubusercontent.com/scribusproject/scribus-translations/master/update_transifex.sh script --pull option] (which will pull all Transifex maintained languages) | ||
===After Release=== | ===After Release=== | ||
# Update the current version in the wiki | # Update the current version in the wiki | ||
#: http://wiki.scribus.net/canvas/Template:Developmental-version | #: http://wiki.scribus.net/canvas/Template:Developmental-version | ||
#: http://wiki.scribus.net/canvas/Template:Stable-version | #: http://wiki.scribus.net/canvas/Template:Stable-version | ||
#:https://wiki.scribus.net/canvas/Announcements | |||
# Release announcement to the mailing list | # Release announcement to the mailing list | ||
# Unleash the translators, asking them to send their translated release announcements to local media | # Unleash the translators, asking them to send their translated release announcements to local media |
Latest revision as of 14:39, 15 June 2024
Release management
Preparing Scribus for a release
Release Day - 3 weeks
- Feature freeze
- E-mail to the mailing list announcing the feature freeze and asking for testing
Release Day - 2 weeks
- String freeze
- Update and commit new ts files
- Push translation files to Transifex, use Transifex script with --push flag
- Send a message to all Scribus translators about the deadline of the upcoming release -- set the deadline for delivering the translations to e.g. "Release Day -3 day"
- To message all translators on Transifex: Log in to Transifex and make an Announcement
- To the translators that aren't using Transifex there is a list (To Be Provided) that will be used to manually group email them
- to the scribus mailing list
Release Day - 1 week
- Send the final version of the (short) release announcement to all translators, asking them to translate it into their languages -- set the deadline for delivering the translations to e.g. "Release Day -1 day"
Release Day - 3 days
- Finish the release notes
- Finish Changelog
- Finish PR spiel for the mailing list and wiki/website.
- Email to all Scribus translators see Release t-2 weeks that the deadline for their translations is about to pass
Release Day - 2 days
Release Day - 1 day
- Commit a new splash and about screen image, and update all versions in a number of source code locations:
Scribus/scribus/ui/about.cpp
Scribus/scribus.lsm
Scribus/config.h.cmake
Scribus/CMakeLists.txt
Scribus/resources/versions/scribusversions.xml
Scribus/README
Scribus/Scribus.app/Contents/Info.plist
Scribus/OSX-package/inputs/Info.plist
Scribus/OSX-package/inputs/Scribus.pkg-Info.plist
Scribus/Changelog
Scribus/win32/msvc2013/scribus-main/Scribus.rc
Scribus/win32/msvc2013/win-config.h
Scribus/win32/msvc2015/scribus-main/Scribus.rc
Scribus/win32/msvc2015/win-config.h
- Prepare a packager's release tarball and alert the packagers.
- Tag the new release
svn copy svn+ssh://[url]/svn/branches/[branchname] svn+ssh://[url]/svn/tags/Release_a.b.c[.rcN] -m "Tag a.b.c[.rcN]"
- OR
svn copy svn+ssh://[url]/svn/trunk svn+ssh://[url]/svn/tags/Release_a.b.c[.rcN] -m "Tag a.b.c[.rcN]"
Release Day
Before Release
- Prepare signed source tarballs and upload both the tarballs and the signatures to SourceForge. X.Y.Z refers to the version being released.
- Check out from SVN from the release tag:
svn co svn+ssh://[url]/svn/tags/Release_X.Y.Z
- Change to the Release_X.Y.Z directory:
cd Release_X.Y.Z
- Rename Scribus directory to scribus-X.Y.Z:
mv Scribus scribus-X.Y.Z
- Run the tar process - we need this file for all of the compression types we want so we do this first:
tar --exclude=.svn -cvf scribus-X.Y.Z.tar scribus-X.Y.Z/
- Compress the files:
- XZ:
xz -k -e -v -z scribus-X.Y.Z.tar
- 7Zip:
7z a -xr'!.*' scribus-X.Y.Z.7z scribus-X.Y.Z/
- BZ2:
bzip2 -k scribus-X.Y.Z.tar
- GZ:
gzip -c scribus-X.Y.Z.tar > scribus-X.Y.Z.tar.gz
- GPG Sign the files:
gpg --default-key <key> --sign --detach-sign --armor scribus-X.Y.Z.7z
gpg --default-key <key> --sign --detach-sign --armor scribus-X.Y.Z.tar.gz
gpg --default-key <key> --sign --detach-sign --armor scribus-X.Y.Z.tar.xz
gpg --default-key <key> --sign --detach-sign --armor scribus-X.Y.Z.tar.bz2
- Verify the files:
gpg --verify scribus-X.Y.Z.7z.asc scribus-X.Y.Z.7z
gpg --verify scribus-X.Y.Z.tar.bz2.asc scribus-X.Y.Z.tar.bz2
gpg --verify scribus-X.Y.Z.tar.gz.asc scribus-X.Y.Z.tar.gz
gpg --verify scribus-X.Y.Z.tar.xz.asc scribus-X.Y.Z.tar.xz
- Create the new directory on Sourceforge for the X.Y.Z version. Set it to staging:
- Under sftp://frs.sourceforge.net/home/frs/project/s/sc/scribus/scribus/X.Y.Z
- OR
- sftp://frs.sourceforge.net/home/frs/project/s/sc/scribus-devel/scribus/X.Y.Z
- Upload to SourceForge:
- Select scribus/scribus-devel directories, then the version number:
- Eg to:
sftp://frs.sourceforge.net/home/frs/project/s/sc/scribus/scribus/X.Y.Z
- OR
sftp://frs.sourceforge.net/home/frs/project/s/sc/scribus-devel/scribus/X.Y.Z
- TODO: Upload Mac, Windows, OS/2 binaries. Turn off staging
- Send a Release email to the mailing list.
Translations
- Pull Translations from Transifex using the script --pull option (which will pull all Transifex maintained languages)
After Release
- Update the current version in the wiki
- Release announcement to the mailing list
- Unleash the translators, asking them to send their translated release announcements to local media
After Specific releases
- Things that have to be done / updated after a specific release (remove them as soon as they're done)
- 1.4: remove the version reference in "If you are using 1.4's release candidates, please be sure to check the online manual (F1)" on [1].
Other things to check
Here is a list of things to check from time to time (and which are not tightly related to the releases). You may also put in this list things which are only temporarily on the website and have to be removed in the future.