Release checklist Plone 6.0.7

[mauritsvanrees]

See the release schedule.

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 @petschki @thet @erral. I am preparing Plone 6.0.7. Could you make releases for "your" packages please?

Proposed schedule:

• Monday 11/12: release packages
• Wednesday/Thursday 13/14: make release candidate
• Tuesday 19: final release.

[thet]

will do on monday!

[petschki]

plonetheme.barceloneta==3.1.4 and plone.staticresources==2.1.6 are ready since mid august. As far as I can see, no more PRs are merged since then.

[erral]

plone.app.locales == 6.0.16 is ready

[sverbois]

New release for plone.app.contentmenu with this merge request plone/plone.app.contentmenu#55 ?

[mauritsvanrees]

Thanks all. We are close to a release candidate now.

@sverbois wrote:

New release for plone.app.contentmenu with this merge request plone/plone.app.contentmenu#55 ?

Yes, I have merged it, thanks for the heads up, I don't follow all repos.
Will make a release of this tomorrow if Jenkins is green, and include it.

[mauritsvanrees]

6.0.7rc1 is out for testing. See community announcement.

[mauritsvanrees]

6.0.7 is out, with security fixes.

[mauritsvanrees]

All done.