Skip to content

Release tracking ticket for GHC 9.0.1

This is the release checklist for the %9.0.1 milestone. See #16816 for the template that this was derived from.

Pre-release checklist

  • (major-only) Remove the release notes for the previous release (e.g. docs/users_guide/8.6.*-notes.rst)
  • (major-only) Make release branch (e.g. ghc-8.8)
  • (major-only) Make post-release branch (e.g. ghc-8.9-start)
  • Ensure that submodules are on released tags (produced using this script):
    • libraries/Cabal: ready for release (on cabal-install-3.4.0.0-rc7)
    • libraries/Win32: version 2.10.0.0
    • libraries/array: needs revision (on v0.5.3.0-8-gab53517)
    • libraries/binary: version 0.8.8.0
    • libraries/bytestring: version 0.10.12.1
    • libraries/containers: version 0.6.4.1
    • libraries/deepseq: version 1.4.5.0 (on v1.4.5.0)
    • libraries/directory: needs revision (on v1.3.6.1-4-gb697b3e)
    • libraries/exceptions: needs revision (on v0.10.4-5-g23c0b8a)
    • libraries/filepath: needs revision (on v1.4.2.1-ghc1-18-g9088df9)
    • libraries/haskeline: https://github.com/judah/haskeline/issues/154 (on 0.8.1.0-1-g2790f1c)
    • libraries/mtl: version 2.2.2
    • libraries/parsec: needs revision (on v3.1.14.0-3-g1904924)
    • libraries/pretty: version 1.1.3.6
    • libraries/process: version v1.6.11.0 (on v1.6.11.0)
    • libraries/stm: todo (on v2.5.0.0-ghc1-14-g444f672)
    • libraries/terminfo: needs revision (on 0.4.1.4-2-g3ebb36f)
    • libraries/text: version 1.2.4.1 (on v1.2.4.1-rc1)
    • libraries/time: version 1.9.3
    • libraries/transformers: version 0.5.6.2
    • libraries/unix: https://github.com/haskell/unix/issues/173 (on v2.7.2.2-r3-9-gea13d99)
    • libraries/xhtml: version 3000.2.2.1
    • utils/haddock: todo (on haddock-2.24.0-release-117-g99f61534)
    • utils/hsc2hs: https://github.com/haskell/hsc2hs/issues/61 (on v0.68.7-4-g7accbea)
  • 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/index.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 in configure.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/integer-gmp
    • libraries/integer-simple
    • 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

Release checklist

  • 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 [TODO: documentation]
    • 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>:
  • 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 on downloads.haskell.org
  • Ensure that the Migration page is up-to-date

Post-release checklist

Edited by Ben Gamari
To upload designs, you'll need to enable LFS and have an admin enable hashed storage. More information