Skip to content

Release CmdStan 2.34 #1230

Closed
Closed

Description

@WardBrian

Feature freeze (January 8th, 2024):

  • Ensure all expiring language deprecations have been removed or given new removal dates.
  • Create and merge version updating pull requests in Math/Stan/Cmdstan. These should be the last PRs accepted before the freeze.
  • Create Math/Stan RC releases.
  • Create Stanc3 RC binary.
  • Create a release candidate tarball for x86. Make sure RC tarballs include stanc3 binaries.
  • Check external links in docs (i.e. TBB docs link) - use https://github.com/tcort/markdown-link-check
  • Create a release candidate feature/bugfix list (major features/bugfixes that need testing, link to new docs in Github)
  • Run CmdStanR tests with the RC tarball.
  • Run CmdStanPy tests with the RC tarball.
  • Make a Discourse RC post.
  • Post a tweet with a link to the Discourse RC post.

Release (January 16th, 2024):

  • Create the Math Release notes.
  • Create the Stan Release notes.
  • Create the Cmdstan Release notes.
  • Create the Stanc3 Release notes, include new deprecations and removals.
  • Rebuild and publish docs for the new version.
  • Check that docs for the previous release links correctly to the newest docs.
  • Create the Math release.
  • Create the Stan release.
  • Create the Stanc3 release.
  • Create x86 CmdStan tarballs (check version, check that the extracted folder is in the cmdstan-version format).
  • Create non-x86 CmdStan tarballs.
  • Run CmdStanR tests with the release tarball.
  • Make a Stan blog release announcement post (thank the sponsors and all contributors, mention new devs).
  • Link to the blog post in a Discourse thread.
  • Make a Twitter announcement.

Activity

  1. mitzimorris commented on Jan 4, 2024

    @mitzimorris
    Member

    are we creating tarballs for Google Colab?

  2. WardBrian commented on Jan 4, 2024

    @WardBrian
    MemberAuthor

    Yes, @serban-nicusor-toptal makes one each release (usually not for RCs, I don’t believe)

  3. serban-nicusor-toptal commented on Jan 5, 2024

    @serban-nicusor-toptal
    Contributor

    I build it always, for RC also. I have some credits and wrote a script so it's fairly easy to do.

  4. serban-nicusor-toptal commented on Jan 8, 2024

    @serban-nicusor-toptal
    Contributor

    Good morning @WardBrian, are we still waiting for stan-dev/stan#3249 ?

  5. WardBrian commented on Jan 8, 2024

    @WardBrian
    MemberAuthor

    Let's give it a few hours to see if we can get #1234

  6. serban-nicusor-toptal commented on Jan 8, 2024

    @serban-nicusor-toptal
    Contributor

    Sounds good, we can also postpone for the following days if #1234 is important.

  7. WardBrian commented on Jan 8, 2024

    @WardBrian
    MemberAuthor

    @serban-nicusor-toptal you should be good to run the RCs as soon as the currently-running jenkins pipelines finish. I'll get started on the release notes and a draft of the blog post.

  8. WardBrian commented on Jan 8, 2024

    @WardBrian
    MemberAuthor

    Here's my working draft of the release notes: https://gist.github.com/WardBrian/e3a6b534f6220df5439df05f08445584

    And the discourse announcement: https://gist.github.com/WardBrian/1ba59bfd0037d3a721efac8934e4ad36

    @rok-cesnovar is helping me with the discourse post, it should be ready to go up as soon as the tarballs are ready

  9. serban-nicusor-toptal commented on Jan 8, 2024

    @serban-nicusor-toptal
    Contributor

    Jenkins finished all develop jobs, I'll start shortly.

  10. serban-nicusor-toptal commented on Jan 8, 2024

    @serban-nicusor-toptal
    Contributor

    Release candidates are up!
    https://github.com/stan-dev/math/releases/tag/v4.8.0-rc1
    https://github.com/stan-dev/stan/releases/tag/v2.34.0-rc1
    https://github.com/stan-dev/cmdstan/releases/tag/v2.34.0-rc1
    https://github.com/stan-dev/stanc3/releases/tag/v2.34.0-rc1

    We were a bit unfortunate with the Jenkins maintenance timing so we'll have to wait until it's online for the non-x64 binaries builds. I'll watch it and do it later when it's back.
    At the same time, for colab builds we were using transfer.sh to take our the builds from the colab machine which went offline recently :( I'll need to figure out a different way to take out the build.

  11. WardBrian commented on Jan 8, 2024

    @WardBrian
    MemberAuthor
  12. 17 remaining items

  13. serban-nicusor-toptal commented on Jan 17, 2024

    @serban-nicusor-toptal
    Contributor

    That sounds good, I'll make a note for next time.
    For now, I'll close the PRs and replace master with develop for math, stan, cmdstan.
    As we used to do before:

    git checkout master
    git reset --hard develop
    git push origin master
    
  14. WardBrian commented on Jan 17, 2024

    @WardBrian
    MemberAuthor

    assuming that works, I think that's what we actually want to happen.
    Because there is a history of merges between the two branches it might not be happy

  15. serban-nicusor-toptal commented on Jan 17, 2024

    @serban-nicusor-toptal
    Contributor

    That's now done! Let's hope everything goes smoothly!

  16. WardBrian commented on Jan 17, 2024

    @WardBrian
    MemberAuthor

    #1238 is probably worthy of a patch. We should wait if anything else comes up too.

  17. WardBrian commented on Jan 18, 2024

    @WardBrian
    MemberAuthor

    stan-dev/stan#3255 and stan-dev/stan#3251 would also go into 2.34.1

    Nothing in Math at the moment

  18. WardBrian commented on Jan 18, 2024

    @WardBrian
    MemberAuthor

    Tentative 2.34.1 release notes:

    CmdStan

    • Fixed an indexing error which could lead to crashes
    • Fixed an issue where output was swallowed by the log_prob method if an error occurred

    Stan

    • Fixed a Windows-specific issue with std::regex in JSON file validation
    • Added a missing include of cstdint
  19. WardBrian commented on Jan 18, 2024

    @WardBrian
    MemberAuthor

    @serban-nicusor-toptal Does monday work for you to run the patch release?

    Currently it would only be for the stan and cmdstan repos - math and stanc3 should be re-used from .0. If something comes up in Math we will need to do a cherry-pick because some non-bugfix PRs have already been merged there.

  20. serban-nicusor-toptal commented on Jan 19, 2024

    @serban-nicusor-toptal
    Contributor

    Hey Brian, Monday is fine with me!

  21. WardBrian commented on Jan 19, 2024

    @WardBrian
    MemberAuthor

    We're also waiting to see if stan-dev/math#3002 is merged. If so, it would be nice to cherry pick a math patch release.

  22. WardBrian commented on Jan 19, 2024

    @WardBrian
    MemberAuthor

    @serban-nicusor-toptal the pr to watch is now stan-dev/math#3007

    This is targetting a branch called staging/v4.8.1. If it is merged before release, we can create release/v4.8.1, add the release notes, and use that as the submodule for the release/v2.34.1 branches elsewhere.

    We can then merge the release branch back into develop of math.

  23. WardBrian commented on Jan 22, 2024

    @WardBrian
    MemberAuthor

    Ok, I just put up #1243 which will hopefully be merged today, release tomorrow.

    Here are the notes:

    Math (releasing from branch staging/v4.8.1):

    - The distributions defined over cholesky factors now check that their arguments are in support (#3007)
    - Fixed an issue with the `inv_wishart_cholesky_rng` function (#3007)
    

    Stan (releasing from develop):

    - Fixed a Windows-specific issue with std::regex in JSON file validation (#3251)
    - Added a missing include of `cstdint` (#3255)
    

    CmdStan (releasing from develop):

    - Fixed an indexing error which could lead to crashes (#1239)
    - Fixed an issue where output was swallowed by the `log_prob` method if an error occurred (#1235)
    - Fixed an issue where floating point arguments would be echoed back to the user with insufficient precision (#1243)
    
  24. serban-nicusor-toptal commented on Jan 23, 2024

    @serban-nicusor-toptal
    Contributor

    Good morning, patch release is ready!

    https://github.com/stan-dev/math/releases/tag/v4.8.1
    https://github.com/stan-dev/stan/releases/tag/v2.34.1
    https://github.com/stan-dev/cmdstan/releases/tag/v2.34.1

    With PRs targeting develop

    stan-dev/math#3011
    stan-dev/stan#3257
    #1244

    After PRs are approved & merged, I will align develop branch with master and that should be the last bit!

  25. WardBrian commented on Jan 25, 2024

    @WardBrian
    MemberAuthor

    With 2.34.1 out I think we can close this issue. Thank you to everyone who helped with this release!

  26. WardBrian commented on Jan 29, 2024

    @WardBrian
    MemberAuthor

    I have made https://github.com/stan-dev/math/tree/staging/v4.8.2, which currently contains cherry-picks of stan-dev/math#3012 and stan-dev/math#3014

    I believe it may be worth doing a .2 for these fixes. We can discuss when it would happen

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions