MAINTAINERS.md

XMonad Maintainers

The XMonad Core Team

• Brandon S Allbery GitHub, IRC: geekosaur, GPG

• Brent Yorgey GitHub, IRC: byorgey

• Daniel Wagner GitHub, Twitter, IRC: dmwit

• Sibi Prabakaran GitHub, Twitter, IRC: sibi

• Tomáš Janoušek GitHub, Twitter, IRC: liskin, GPG

• Tony Zorman GitHub, IRC: Solid, GPG

Hall of Fame (past maintainers/developers)

• Adam Vogt GitHub

• Peter Simons GitHub, Twitter

• Spencer Janssen GitHub

• Don Stewart GitHub, Twitter

• Jason Creighton GitHub

• David Roundy GitHub

• Daniel Schoepe GitHub

• Eric Mertens GitHub

• Nicolas Pouillard GitHub

• Roman Cheplyaka GitHub

• Gwern Branwen GitHub

• Lukas Mai GitHub

• Braden Shepherdson GitHub

• Devin Mullins GitHub

• David Lazar GitHub

• Peter J. Jones GitHub

Release Procedures

When the time comes to release another version of xmonad and xmonad-contrib:

1. Update the version number in all the *.cabal files and let the CI verify that it all builds together.

2. Review documentation files and make sure they are accurate:

   • README.md
   • CHANGES.md (bump version, set date)
   • INSTALL.md
   • man/xmonad.1.markdown.in
   • haddocks

   If the manpage changes, wait for the CI to rebuild the rendered outputs.

3. Update the website:

   • Draft a new release announcement.
   • Check install instructions, guided tour, keybindings cheat sheet, …

4. Make sure that tested-with: covers several recent releases of GHC, that .github/workflows/haskell-ci.yml had been updated to test all these GHC versions and that .github/workflows/stack.yml tests with several recent revisions of Stackage LTS.

5. Trigger the Haskell-CI workflow and fill in the candidate version number. This will upload a release candidate to Hackage.

   • https://github.com/xmonad/xmonad/actions/workflows/haskell-ci.yml
   • https://github.com/xmonad/xmonad-contrib/actions/workflows/haskell-ci.yml

   Check that everything looks good. If not, push fixes and do another candidate. When everything's ready, create a release on GitHub:

   • https://github.com/xmonad/xmonad/releases/new
   • https://github.com/xmonad/xmonad-contrib/releases/new

   CI will automatically upload the final release to Hackage.

   See haskell-ci-hackage.patch for details about the Hackage automation.

6. Post announcement to:

   • xmonad.org website
   • XMonad mailing list
   • Haskell Cafe
   • Haskell Discourse
   • Twitter
   • Reddit

   See old announcements (even older) for inspiration.

7. Trigger xmonad-docs build to generate and persist docs for the just released version:

   • https://github.com/xmonad/xmonad-docs/actions/workflows/stack.yml

8. Bump version for development (add .9) and prepare fresh sections in CHANGES.md.

Website and Other Accounts

• The xmonad twitter is tended to by liskin.

• The xmonad.org domain is owned by eyenx and the website itself is deployed via GitHub Pages. It can be updated by making a pull request against the xmonad-web repository.