Checklist

Before release:

1. Check milestone is complete

    https://github.com/AshleyYakeley/Truth/milestones

2. Pull upstream changes (if necessary)

    git checkout master
    git pull

3. Update version numbers

    Makefile
    flake.nix
    common.yaml
    Pinafore/pinafore-app/package.yaml

4. Update changelogs

    deb/changelog.m4
    support/vsc-extension/CHANGELOG.md

5. Use latest LTS resolver

    https://www.stackage.org/lts
    stack.yaml
    docker/Dockerfile

6. Update flake inputs.nixpkgs.follows to match latest stable version

    flake.nix

7. Update Dockerfile source image version to nix version from flake inputs.nixpkgs.follows

    https://search.nixos.org/packages
    docker/Dockerfile

8. Use latest stack

    stack upgrade  # if not using nix
    stack --version

9. Make releases for all modified packages in external/

    external/*
    stack.yaml

10. Update locks

    make update-locks

11. Commit and push changes to repo

    git commit -a
    git push

12. Build & test

    make top-release

13. Run test UI

    bin/testpinafore Pinafore/pinafore-app/test/script/test
    # time zone in stack's docker containter will be UTC

14. Tag commit

    git tag -a -s v<VERSION> -m "Version <VERSION>"
    git push --tags

15. Upload to Github

    https://github.com/AshleyYakeley/Truth/releases

16. Upload documentation to pinafore.info

    (use script)
    https://pinafore.info/

17. Close completed milestone

    https://github.com/AshleyYakeley/Truth/milestones