Post-Release tasks

Post-Release Tasks for the Zen Cart Forum

• Add the new version to the Zen Cart Version dropdown on the forum for new thread creation. (Note that this is not required for patch releases.)

Instructions:

- Login to the admin panel for zen-cart.com
- Thread Prefixes -> Thread prefix manager 
- Where it says "Zen Cart version", click on Add Prefix 

then set prefix id, title (both) to the version 
e.g. v158
leave display order as 10 
click Save

• Add the new version as a checkbox to the plugin version list. (Note that this is not required for patch releases.)

Instructions:

- Login to the admin panel for zen-cart.com

- Maintenance -> Execute SQL Query 

insert into vb_dl2_zcversions (versiontext) values ('v1.5.8')

Other Post-Release Tasks

The first item applies to all releases; subsequent items are for major releases only.

• Update the Release History page with the new version and date.

• Create a “Known Bugs in ” thread on the Upgrading to 1.5.x subforum. Update the release announcement and the known bugs page with this link.

• Ensure the Release Specific Upgrade Considerations doc has a statement about this release.

• Search the documentation in https://github.com/zencart/documentation for the string RELEASETIME and update those files.

• Run the build_doc and view schema tools.

  • build_doc is in the Zen Cart Tools repo. It creates the configuration documentation.
  • view_schema is a plugin located here. It creates the schema documentation. Install the plugin, then do an Inspect in Google Chrome on the output and copy the element with id=“pageWrapper” into a new file in zencart_documentation/content/dev/schema. Remove the opening and closing div tags.

• Emergency Re-release: If something was missed and you have to do a re-release, go back to Remedial Commits.

A day or two after the build has been released when you’re confident that all is well:

• Message all developers who have merge privileges using the Skype Dev Chat channel, and then unlock the branch you are building. Go to the branches page and de-activate the branch protection rule you created earlier (uncheck the “PR required” checkbox for the rule).

• Begin process of formally merging release to Master/Main FIXME - unsure

• Take some time to review the What’s New document in the release folder to be sure it’s complete.

Post-Release Things to Consider

• Is it time to remove old versions from the plugin version list?

• Is it time to hide older what’s new / changed files documents in the releases folder?

• Are there old stuck posts on the forum that should be unstuck?

• Check the Zen Cart and Zen Cart Documentation project for tags that mark things that need to be taken care of - there might be a ‘Post Release 1.5.X’ tag or something like that, for example.