Release checklist Plone 6.0.10

[mauritsvanrees]

Release packages, update versions

• Check Jenkins Status: should be green. (This should be checked often during the release process.)
• In coredev, check packages for updates: bin/manage report --interactive. This is less needed now that we have mr.roboto to add packages to the checkouts. Use bin/versioncheck to see if any new PyPI releases are worth adding, or check the artifact of the versioncheck GitHub Action.
• Release individual packages from checkouts.cfg.
• Check that the version numbers of CMFPlone metadata.xml and latest upgrade step are in sync, and that they are higher than in the previous Plone release.
• Handle special packages, often handled by special people. :-) You can can ping people in the release-team channel on Discord, in the current issue, or individually:
  • plonetheme.barceloneta needs a release on PyPI and npmjs. Maybe ask Peter Holzer (agitator) or Peter Mathis (petschki) for assistence.
  • plone.staticresources and mockup. Ask on Discord in the classic-ui or ask Johannes (thet), Peter Mathis (petschki) or Maik (MrTango).
  • plone.restapi and maybe plone.volto. If needed, ask the Plone REST api team or Timo (tisto) for a new release.
  • plone.app.locales. Create an issue there or ask Mikel (erral).
  • Release plone.app.upgrade and Plone yourself.
  • Update the versions of those packages in versions.cfg.
• Make an alpha/beta/release candidate release of Products.CMFPlone (e.g. 6.0.0a1, later 6.0.0b1 and 6.0.0rc1). Fine to release this on PyPI. Once Plone 6 is final, we can continue doing release candidates for the bugfix releases, so people can try it in a pending release.

Release notes, constraints, dist.plone.org

• Adjust coredev branch release/6.0-dev. Most importantly, the auto-checkout list in checkouts.cfg should be empty, and the versions.cfg and requirements.txt should be the same. One way that works for me: git checkout release/6.0-dev; git reset --hard 6.0; git reset origin/release/6.0-dev. Then check which changes you want to commit.
• Update the 6.0-dev directory on dist.plone.org, and gather files to put there:
  • You can use tox -c release/tox.ini -p auto to create or copy some files in release/dist. But you need to create some of those files first.
  • Create a unified changelog based on the previous release: bin/manage changelog --start=6.0.0a1 > release/changelog.txt. Remove the uninteresting top lines. You may want to link to the Zope changelog with a specific tag.
  • Create a file release/RELEASE-NOTES.md. It may be enough to look through the changelog and copy interesting changes.
  • Get the versions.cfg file and any other versions files from coredev.
  • Create a release/constraints.txt file from this. The above tox command generates this. Note: at some point I expect the constraints file to become leading, and we may need to generate a versions.cfg file instead.
  • Copy (rsync) these files to the pending release directory. (We used to copy packages as well, but we do not do this for Plone 6 anymore.)
• Write a post on community.plone.org announcing a pending/soft release. See example. In the 6.0 alpha/beta/rc stage, we can skip pending releases and just make a real release.
• Wait for feedback, preferably at most a few days. As said, in the alpha/beta/rc stage, we can skip this.

Final release, Docker

• Make final release of Products.CMFPlone to PyPI, update versions.cfg.
• In release/6.0-dev branch update changelog, release notes, constraints.txt.
• Create tag of the release/6.0-dev branch, e.g. 6.0.0a1, and push to GitHub.
• Make final release directory on dist.plone.org, with versions, requirements, constraints, changelog, release notes.
• Update the "-latest" links on dist.plone.org, e.g. ln -sfT 6.0.0a1 6.0-latest
• Notify Érico Andrei and/or Fred van Dijk in the #release-team Discord channel that there is a new release. They will create Docker images. Examples of changes: README.md and version.txt.

Announcements

You probably want to wait until the Docker images are there, but don't wait long.

• Create release page on https://plone.org/download/releases
• Send mail to Marketing Team so they can prepare announcements.
• Update the https://plone.org/security/hotfixes/ page in the configuration control panel. This is done in the configuration registry: plone.securitysupport, plone.versions, plone.activemaintenance. You could ask the security team.
• Publish release page on plone.org.
• Update the release schedule: note the new release, and say when the next release in this series is expected.
• Edit the link on https://plone.org/download.
• Announce on community.plone.org.
• In plone/documentation's conf.py, update PLONE_BACKEND_PATCH_VERSION and PLONE_BACKEND_MINOR_VERSION as needed. Ask Steve Piercy or do it yourself. Here is a sample PR.
• Ask Philip Bauer and/or Fred van Dijk to update the demo sites. Here is a sample PR.

[mauritsvanrees]

@tisto @sneridagh @petschki @erral I would like to release Plone 6.0.10. Could you release your packages please?

• Monday 19 / Tuesday 20 February: release packages
• Wednesday 21 / Thursday 22: make release candidate
• Monday 26 / Tuesday 27: make final release

Thanks!

[erral]

Released plone.app.locales = 6.0.20

[sneridagh]

@mauritsvanrees https://github.com/plone/volto/releases/tag/17.14.0

Also another alpha of 18: https://github.com/plone/volto/releases/tag/18.0.0-alpha.11

[petschki]

@mauritsvanrees Classic-UI releases:

pypi
plone.staticresources==2.1.10
plonetheme.barceloneta==3.1.8

npmjs
@plone/mockup==5.1.9
@plone/plonetheme-barceloneta-base==3.1.8

[mauritsvanrees]

Plone 6.0.10rc1 is available:

• https://community.plone.org/t/plone-6-0-10-soft-released/18877
• https://dist.plone.org/release/6.0-dev/

[wesleybl]

@mauritsvanrees can you please add plone.restapi 9.5.0?

[mauritsvanrees]

@mauritsvanrees can you please add plone.restapi 9.5.0?

Will do.

There are some more late fixes to other packages that I can include. It makes me wonder if there is still value in doing these pending/rc releases. I can't remember the last time something was really broken in such a release and we needed a fix. Mostly any changes after the pending release are minor fixes or improvements that could also wait for a next release.

So we could also skip this phase the next time, and go for a final release immediately. If something really is broken, I could still simply make the next release (6.0.11) or a "sub" release (6.0.10.1). We can briefly discuss this in the Steering Circle next week.

Anyway, I will make some final changes and release 6.0.10 now.

[ale-rt]

@mauritsvanrees it would be great to also have plone/plone.dexterity#196

[mauritsvanrees]

@mauritsvanrees it would be great to also have plone/plone.dexterity#196

It is in. The release is final now:

• https://dist.plone.org/release/6.0.10/
• https://plone.org/download/releases/6.0.10 (private, waiting for Docker images)

And I did 6.1.0a2 as well. That was not so much extra work, with most packages already having been released. Sorry, I did not consult with anyone about that, a bit spur of the moment.

• https://dist.plone.org/release/6.1.0a2/
• https://plone.org/download/releases/6.1.0a2 (public, we are not waiting for Docker images here)

[mauritsvanrees]

A problem was found in the folder contents view of Classic UI. This is fixed in a new release 6.0.10.1. See https://community.plone.org/t/plone-6-0-10-1-released/18961