0.3.0 Release Plan

[jtpio]

0.3.0a0 was just published: https://github.com/voila-dashboards/voila/releases/tag/v0.3.0a0

main now targets the 0.3.0 release. And there is the 0.2.x branch to cut new patch releases for 0.2 if needed (0.2.17, 0.2.18, ...).

0.3.0 milestone

For issues and PRs that should go to the 0.3.0 release, we add them to the 0.3.0 milestone: https://github.com/voila-dashboards/voila/milestone/4

This will be the case for anything major, or a PR that introduces backward incompatible changes with 0.2.x.

Making a new 0.3.0 pre-release

We use the Jupyter Releaser as documented in:

https://github.com/voila-dashboards/voila/blob/main/RELEASE.md#using-jupyter_releaser

As an example, the current version is 0.3.0a0. If we want to release 0.3.0a1, we do the following:

Draft Changelog

With next as the version spec:

We then wait for:

1. the PR to be created on the repo. Example: Automated Changelog Entry for 0.3.0a0 on main #990
2. Tests to pass
3. Merge the changelog PR

Full Release

Using the information in the body of the changelog PR, for example:

We use the Full Release workflow:

Backporting changes to 0.2.x

We use https://github.com/meeseeksbox to backport changes to the 0.2.x branch if needed: https://github.com/voila-dashboards/voila/tree/0.2.x

Making a new 0.2.x release

We use the Jupyter Release, specifying the 0.2.x when launching the workflows.

---

cc @voila-dashboards/voila-core

Let me know if all of this makes sense, and if you would like to cut new releases with the releaser and need guidance. Don't hesitate to comment here otherwise.

[trungleduc]

Hi all, with the recent changes ( #936 #999 ) about the new preheated kernel mode, the backend of Voila is refactored intensively. Should we shorten the release cycle of Voila and push the frontend refactoring (#846 ) to 0.4.0 ?

[jtpio]

Should we shorten the release cycle of Voila and push the frontend refactoring (#846 ) to 0.4.0 ?

Pushing #846 to 0.4.0 sounds good to me, there are still a couple of things to fix there.

I think we should still go through the alpha -> beta -> rc release cycle. If we want to shorten then we can start releasing 0.3.0bx, and then 1-2 weeks later rc and final. But once in beta we should not add new breaking changes.

[SylvainCorlay]

+1 on both proposals

[trungleduc]

Pushing #846 to 0.4.0 sounds good to me, there are still a couple of things to fix there.

I think we should still go through the alpha -> beta -> rc release cycle. If we want to shorten then we can start releasing 0.3.0bx, and then 1-2 weeks later rc and final. But once in beta we should not add new breaking changes.

Yes I mean shorten the feature list but not the release process.

[jtpio]

Alright sounds good, thanks for the clarifications 👍

We could also do a quick pass on the open PRs and see if some of them could make it to 0.3.0.

[jtpio]

Thanks @trungleduc for taking care of the 0.3.0a2 release!

[trungleduc]

0.3.0 milestone is clean, we can release 0.3.0b0 now?

[jtpio]

Thanks @trungleduc for clearing the remaining items and reporting here.

Looks like we should indeed be able to bump. In that case we can use release as the spec in the releaser workflows (first the changelog then the full release).

[trungleduc]

ok, I'll do it.

[trungleduc]

0.3.0b0 is out!

[jtpio]

Nice, thanks @trungleduc!

[trungleduc]

Hello all, 0.3.0rc0 is released today. The release candidate phase is planned for about 2 weeks and we will try to have the final by early December.

[trungleduc]

Hello all, we had 3 weeks of RC for now, is it ok for you to release the final version?

[jtpio]

Sounds good!

Let's get these 2 PRs in first?

• Backport PR #1037 on branch main (Updating Heroku deploy instructions) #1039
• Enforce labels on PRs #1038

[trungleduc]

Yes, I want to do a quick pass for the tests on Windows too.

[jtpio]

The version spec to use in the releaser to make the final release will be release.

[trungleduc]

Thanks @jtpio, will do it today.

[jtpio]

Closing as 0.3.0 has now been released: https://github.com/voila-dashboards/voila/releases/tag/v0.3.0

Thanks @trungleduc!

[jtpio]

Create a new 0.3.x milestone to track future 0.3.x patches: https://github.com/voila-dashboards/voila/milestone/6