9.4.1 release tracking
This is the template to be used to create release tracking tickets. Copy this into a new issue and fill in the TODOs. Those items marked with major-only can be ignored for minor releases.
This is the release checklist for the TODO milestone. See #16816 (closed) for the template that this was derived from.
Pre-fork checklist (major-only)
When forking a new release branch for a new major release series (e.g. ghc-9.0
), please check the following:
-
Verify that haddock
's development branch (namely the branch corresponding to GHC's previous major release, e.g.ghc-8.10
) has been merged intoghc-head
. -
Remove the release notes for the previous release (e.g. docs/users_guide/8.6.*-notes.rst
) -
Create the new branch: git branch ghc-9.0
-
In the new branch bump the version number in configure.ac
to, e.g.,9.0
-
In master
bump the version number to that of the next development series, e.g.,9.1
-
Tag this master
commit as, e.g.,ghc-9.1-start
-
Push all of the above tags and branches -
After forking remove release notes from master
and start a new set of release notes for the next release
Pre-release checklist
-
Ensure that submodules are on released tags (the below is produced using this script): -
libraries/Cabal
: version 3.8.1.0 -
libraries/Win32
: version 2.12.0.0 -
libraries/array
: version 0.5.4.0r1 -
libraries/binary
: version 0.8.9.1 -
libraries/bytestring
: version 0.11.3.1 -
libraries/containers
: version 0.6.6 -
libraries/deepseq
: version 1.4.8.0 -
libraries/directory
: version 1.3.7.1 -
libraries/exceptions
: verison 0.10.5r1 -
libraries/filepath
: version 1.4.2.2 -
libraries/haskeline
: on 0.8.2r2 -
libraries/mtl
: version 2.2.2 -
libraries/parsec
: version 3.1.15.0 -
libraries/pretty
: version 1.1.3.6 -
libraries/process
: version 1.6.15.0 -
libraries/terminfo
: on 0.4.1.5r1 -
libraries/stm
: on 2.5.1.0 -
libraries/text
: Blocked on https://github.com/haskell/text/issues/450 -
libraries/time
: version 1.12.1 -
libraries/transformers
: version 0.5.6.2 -
libraries/unix
: version 2.7.3 -
libraries/xhtml
: version 3000.2.2.1 -
utils/haddock
: https://github.com/haskell/haddock/commit/2368e9329e6600b46000abd24ec00b7e27bcae75 -
utils/hsc2hs
: version 0.68.8
-
-
Non-released submodules up-to-date: -
nofib
-
libffi-tarballs
-
libraries/integer-gmp/gmp/gmp-tarballs
-
-
Release notes ( docs/users_guide/x.y.z-notes.rst
) written -
Release notes linked in docs/users_guide/release-notes.rst
-
autoconf
scripts updated -
Check that Unicode database in base
(libraries/base/cbits/README.Unicode
) reflects current standard release (http://www.unicode.org/versions/latest/) -
LlvmVersion
inconfigure.ac
is targetting intended LLVM version -
Release notes mentions LLVM version requirement -
llvm-targets
file updated -
Changelogs updated (these can be checked using .gitlab/linters/check-changelogs.sh
):-
libraries/ghc-prim
-
libraries/ghc-bignum
-
libraries/hpc
-
libraries/base
-
-
Verify that the ~"backport needed" label has no more issues/merge requests needing backport -
Verify that all CI builds are green before moving to release checklist -
Update hadrian bootstrap plans for the latest compiler releases
Release checklist
-
Ensure that the Migration page is up-to-date -
Push a provision provisional release commit to trigger the release builds using git push -o ci.variable="RELEASE_JOB=yes"
-
Wait until builds finish; verify that they finished successfully -
Fetch release artifacts TODO: documentation -
Sign and push release artifacts to downloads.haskell.org
[TODO: documentation] -
Make a release tag -
Release/revise GHC-maintained libraries on Hackage using this script: -
libraries/base
-
libraries/ghc-prim
-
libraries/array
-
libraries/stm
-
libraries/ghc-heap
-
libraries/ghc-compact
-
libraries/ghc-boot
-
libraries/ghc-boot-th
-
libraries/hpc
-
libraries/libiserv
-
libraries/template-haskell
-
libraries/ghc-bignum
-
-
Update ghc/homepage>: -
Write download page (see ghc/homepage>) -
Check that download page has a section for each bindist in the downloads folder. -
Add news item to index.html
-
Add link to download.shtml
. Be sure to link to the Migration guide. -
Look over changes locally -
Add release announcement to GHC blog. Be sure to link to the Migration guide. -
Push changes to master
-
-
Announce on: GHC developers <ghc-devs@haskell.org>, GHC Users <glasgow-haskell-users@haskell.org>, Haskell Cafe <haskell-cafe@haskell.org>
-
Announce on: Haskell Discourse, /r/haskell, Twitter -
Update latest
symlink ondownloads.haskell.org
Post-release checklist
-
Update the Wiki status page -
Update the language pragma history -
Mark milestone as closed -
Update /topic
in#ghc
-
Update the VersionHistory wiki page -
Set RELEASE=NO
-
Create a release tracking ticket for the next release using the template in #16816 (closed)