{"type":"doc","content":[{"type":"panel","attrs":{"panelIconId":"1f6a7","panelIcon":":construction:","panelIconText":"🚧","panelColor":"#FFFAE6","panelType":"custom"},"content":[{"type":"paragraph","content":[{"text":"This page could use several updates, including:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"All the inline comments on this page","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Everything here, which came up during Nutmeg and Olive: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://github.com/openedx/build-test-release-wg/issues/185"}},{"text":" ","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Contents","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"1065461c-4cc0-41a5-a76a-14dd1ab99e3f"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"33d98105-053a-4ee0-9711-a6215782fa85"}},{"type":"heading","attrs":{"level":1},"content":[{"type":"emoji","attrs":{"id":"1f3d9","text":"🏙️","shortName":":cityscape:"}},{"text":" Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"This document explains how to make an Open edX release. In this document, I'll use \"zebrawood\" for the release you are making, and \"yucca\" for the previous release.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Schedule","type":"text"}]},{"type":"paragraph","content":[{"text":"The schedule of cuts and releases is maintained here: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://openedx.atlassian.net/wiki/spaces/COMM/pages/131531237"}},{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Repos","type":"text"}]},{"type":"paragraph","content":[{"text":"An Open edX release is comprised of specific versions of many repos. The participating repos all exist in the ","type":"text"},{"text":"openedx GitHub organization","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/openedx/"}}]},{"text":" and are ","type":"text"},{"text":"determined by examining the catalog-info.yaml files in each repo","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"dab13620-bdeb-4738-bf62-a522d2f9c98f"}}]},{"text":". In other words, every repository that has an ","type":"text"},{"text":"catalog-info.yaml","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"f72b2bcd-5e62-4bee-bf0f-c318117e8eb2"}}]},{"text":" file in its root may or may not participate in the release, depending on the contents of the file. In particular, this line needs to be present:","type":"text"}]},{"type":"codeBlock","content":[{"text":"metadata:\n annotations:\n openedx.org/release: \"main\"","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Tags and Branches","type":"text"}]},{"type":"paragraph","content":[{"text":"The release will have a branch in each participating repo. This is the branch where releases are made. This branch is named \"open-release/RELEASENAME.master\", for example, \"open-release/zebrawood.master\". Specific versions will be tagged on that branch, like \"open-release/zebrawood.1\". The first version will be \".1\", not \".0\".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"tag_release.py","type":"text"}]},{"type":"paragraph","content":[{"text":"To make the process practically feasible, a ","type":"text"},{"text":"tag_release.py","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/edx/repo-tools/blob/master/edx_repo_tools/release/tag_release.py"}}]},{"text":" script exists in ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://github.com/edx/repo-tools"}},{"text":" . In short, on each run it will discover which repositories are eligible for a release by listing all repos in the configured organizations (the default is edx, edx-ops, and edx-solutions) and examining their respective ","type":"text"},{"text":"catalog-info.yaml","type":"text","marks":[{"type":"code"}]},{"text":" files. If a given repository is indeed eligible, the script will execute the requested branching or tagging operation on it.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Release Manager Permissions","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"release manager","type":"text","marks":[{"type":"em"}]},{"text":" is a position in the Build-Test-Release WG. As part of their position, they should be nominated for the ","type":"text"},{"text":"Release Manager Core Contributor Role","type":"text","marks":[{"type":"link","attrs":{"href":"https://openedx.atlassian.net/wiki/spaces/COMM/pages/2759460357/Core+Contributor+Role+Definitions#Release-Manager---Sarina"}}]},{"text":" , and hopefully confirmed for the role, which allows them to be granted write permissions on every repository that is part of the release.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If so:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Before cutting or tagging any release:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Confirm that the release manager is, in fact, a member of the ","type":"text"},{"text":"community-release-manager","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/orgs/openedx/teams/community-release-managers/members"}}]},{"text":" GitHub team. If not, have someone from Axim add them.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Confirm that the ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"2cce021c-70b0-441f-b52c-536dc8909d4b"}}]},{"text":"community-release-manager","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"2cce021c-70b0-441f-b52c-536dc8909d4b"}},{"type":"link","attrs":{"href":"https://github.com/orgs/openedx/teams/community-release-managers/members"}}]},{"text":" GitHub team grants ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"2cce021c-70b0-441f-b52c-536dc8909d4b"}}]},{"text":"write","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"2cce021c-70b0-441f-b52c-536dc8909d4b"}},{"type":"strong"}]},{"text":" access to ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"2cce021c-70b0-441f-b52c-536dc8909d4b"}}]},{"text":"all","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"2cce021c-70b0-441f-b52c-536dc8909d4b"}},{"type":"em"}]},{"text":" the repos in the release and ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"2cce021c-70b0-441f-b52c-536dc8909d4b"}}]},{"text":"only","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"2cce021c-70b0-441f-b52c-536dc8909d4b"}},{"type":"em"}]},{"text":" the repos in the release.","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"2cce021c-70b0-441f-b52c-536dc8909d4b"}}]}]}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If not: ","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Before cutting or tagging any release:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Invite an Axim team member to the release ceremony. They will need to add the release manager to ","type":"text"},{"text":"community-release-manager","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/orgs/openedx/teams/community-release-managers/members"}}]},{"text":" add the beginning of the ceremony and remove them from it add the end.","type":"text"}]}]}]}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"type":"emoji","attrs":{"id":"2702","text":"✂️","shortName":":scissors:"}},{"text":" Cutting a release (Making the Master Branches)","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"1. Prepare for the cut a week before it is scheduled….","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"1a. Schedule a release ceremony","type":"text"}]},{"type":"paragraph","content":[{"text":"Schedule a meeting for the day of release, including:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The release manager (you!)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"At least one other Build-Test-Release WG member to check your work, take notes, etc.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If necessary, someone from Axim to grant permissions (see “","type":"text"},{"text":"Overview / Release Manager Permissions","type":"text","marks":[{"type":"underline"}]},{"text":"” section).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Anyone else who wants to listen in!","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"1b. Pre-announce the master branches","type":"text"}]},{"type":"paragraph","content":[{"text":"Make a ","type":"text"},{"text":"post like this one","type":"text","marks":[{"type":"link","attrs":{"href":"https://discuss.openedx.org/t/palm-master-branches-are-coming/9760"}}]},{"text":" in Discourse to let people know that the master branches will be created.","type":"text"}]},{"type":"paragraph","content":[{"text":"Get a 2U person to poke engineers inside 2U about it too.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"1c. Create a wiki pages for release process notes","type":"text"}]},{"type":"paragraph","content":[{"text":"Create a child of this page for your own notes: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://openedx.atlassian.net/wiki/spaces/COMM/pages/3734896715"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"Example: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://openedx.atlassian.net/wiki/spaces/COMM/pages/3727818753"}},{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"2. Hold a release cutting ceremony","type":"text"}]},{"type":"paragraph","content":[{"text":"Get together on a video call. Release manager: share your screen so everyone can follow along. If everyone’s comfortable with it, record it for future reference.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"2a. Freeze edx-sandbox for the release","type":"text"}]},{"type":"paragraph","content":[{"text":"Starting with Quince, we need to freeze the Python dependency pins for ","type":"text"},{"text":"the edx-platform codejail sandbox environment","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/openedx/edx-platform/tree/8eb9ee7b5c758351fe197a203f82c1141e127f61/requirements/edx-sandbox"}}]},{"text":" (also known as “edx-sandbox”). This allows operators to smoothly upgrade their instructor-authored code from release to release. The file needs to exist both in the release and on master, so this step needs to be done ","type":"text"},{"text":"before the release cut","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"To do this:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"copy ","type":"text"},{"text":"./requirements/edx-sandbox/base.txt","type":"text","marks":[{"type":"code"}]},{"text":" to a new file named ","type":"text"},{"text":"./requirements/edx-sandbox/releases/","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"git-add the new file and open a pull request against edx-platform master ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"tag someone for review and merge it before cutting the release.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"That’s it! Here’s an example: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://github.com/openedx/edx-platform/commit/8eb9ee7b5c758351fe197a203f82c1141e127f61"}},{"text":" .","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"2b. Testing before creating release branches","type":"text"}]},{"type":"paragraph","content":[{"text":"If you want to try a dry-run of the release before making any release branches, make a branch under your personal name. Don't use the full release name in the branch name, or people will think it's a release. Follow the instructions for \"Create the release branches\", but use \"yourname/test-z.1\" instead of \"open-release/zebrawood.master\", for example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"$ tag_release --doit --skip-repo \"*-internal\" --branch yourname/test-z.1","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"2c. Create the release branches","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"paragraph","content":[{"text":"The repo-tools repo has a script, tag_release.py, to branch and tag the proper repos. The repos are indicated by an ","type":"text"},{"text":"openedx.org/release","type":"text","marks":[{"type":"code"}]},{"text":" entry in their catalog-info.yaml file. Releases before Ficus would mark dependent repos (those installed by other repos, such as XBlock being installed by edx-platform). We no longer branch or tag dependent repos.","type":"text"}]},{"type":"codeBlock","content":[{"text":"$ tag_release --doit --skip-repo \"*-internal\" --branch open-release/zebrawood.master\nedx/configuration: master (branch) d213681\n 2016-02-17 Fred Smith: Merge pull request #2784 from edx/add-support-url\nedx/edx-analytics-data-api-client: 0.6.1 (tag) d621288\n 2015-05-07 Dennis Jen: Merge pull request #20 from edx/dsjen/update-setup\nedx/edx-certificates: master (branch) a2ed4ed\n 2015-08-28 Kelketek: Merge pull request #49 from edx/make_tmp_dir\nedx/edx-platform: release (branch) 71b3080\n 2016-02-17 Nimisha Asthagiri: Merge pull request #11532 from edx/rc/2016-02-16\n.. and other repo information ..\nIs this correct? [y/N] y\nSuccess!","type":"text"}]},{"type":"paragraph","content":[{"text":"The tag_release.py script has other options to control it in various ways.","type":"text"}]},{"type":"paragraph","content":[{"text":"The branch will be created based on the current state of the release branches described in each repo's ","type":"text"},{"text":"catalog-info.yaml","type":"text","marks":[{"type":"code"}]},{"text":". In particular, for edx-platform, this will be a daily release. Make note of which release it was, people will want to know this.","type":"text"}]},{"type":"paragraph","content":[{"text":"Double-check what the script did to see that it looks correct.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"3. Make announcements rights after the release is cut","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3a. Get release notes started","type":"text"}]},{"type":"paragraph","content":[{"text":"Tell your doc writer the date the release was based on. Also find the date the previous release was based on. They will use these two dates to comb the edx.org release notes for information to go into the Open edX release notes.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3b. Get the blog post started","type":"text"}]},{"type":"paragraph","content":[{"text":"??? Reach out to ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"79d17e68-e388-4515-8a9e-4c49332e7ec2"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3c. Update the release planning wiki pages","type":"text"}]},{"type":"paragraph","content":[{"text":"Consider “","type":"text"},{"text":"Yucca","type":"text","marks":[{"type":"em"}]},{"text":"” to be the release you are cutting now, and “","type":"text"},{"text":"Zebrawood","type":"text","marks":[{"type":"em"}]},{"text":"” to be the next release after that (six months from now).","type":"text"}]},{"type":"paragraph","content":[{"text":"Under ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://openedx.atlassian.net/wiki/spaces/COMM/pages/13205845"}},{"text":" …","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a new planning page for the next release:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Name it ","type":"text"},{"text":"Next Release: Zebrawood","type":"text","marks":[{"type":"underline"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You can use ","type":"text"},{"text":"Next Release: Yucca","type":"text","marks":[{"type":"underline"}]},{"text":" page as a template for the structure of the page.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Indicate that current planning page, ","type":"text"},{"text":"Next Release: Yucca","type":"text","marks":[{"type":"underline"}]},{"text":", is no longer active:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rename it ","type":"text"},{"text":"Upcoming Release: Yucca","type":"text","marks":[{"type":"underline"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add a warning that new changes should be added to ","type":"text"},{"text":"Next Release: Zebrawood.","type":"text","marks":[{"type":"underline"}]}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Finally, update ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://openedx.atlassian.net/wiki/spaces/COMM/pages/3613392957"}},{"text":" .","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3d. Announce the creation of the Open edX release branch","type":"text"}]},{"type":"paragraph","content":[{"text":"Make a forum post in the Announcement category saying that the branches have been cut and explaining what that means. For example:","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"5299bd87-96b7-43a7-9981-83a2f2090acc"}}]}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Hey Open edX developers,","type":"text"}]},{"type":"paragraph","content":[{"text":"TL;DR:","type":"text","marks":[{"type":"strong"}]},{"text":" We are now in the pre-release phase for the next Open edX release: ","type":"text"},{"text":"Palm","type":"text","marks":[{"type":"strong"}]},{"text":". Code merged to master now will ","type":"text"},{"text":"not","type":"text","marks":[{"type":"em"}]},{"text":" be part of Palm. Keep this in mind as you make changes to master, especially ","type":"text"},{"text":"needed fixes:","type":"text","marks":[{"type":"strong"}]},{"text":" They will need ","type":"text"},{"text":"special attention","type":"text","marks":[{"type":"strong"}]},{"text":", so reach out.","type":"text"}]},{"type":"paragraph","content":[{"text":"What is Palm? ","type":"text","marks":[{"type":"strong"}]},{"text":"The next Open edX community release is named Palm. It will be based on the code as of today. We can include your future changes if you ","type":"text"},{"text":"alert","type":"text","marks":[{"type":"strong"}]},{"text":" us to them. ","type":"text"}]},{"type":"paragraph","content":[{"text":"What happened: ","type":"text","marks":[{"type":"strong"}]},{"text":"Today we created the ","type":"text"},{"text":"open-release/palm.master ","type":"text","marks":[{"type":"strong"}]},{"text":"branches in our repos. As of now, changes you merge to master will contribute to the release","type":"text"},{"text":" after","type":"text","marks":[{"type":"em"}]},{"text":" Palm, which will be called Quince.","type":"text"}]},{"type":"paragraph","content":[{"text":"What you should do: ","type":"text","marks":[{"type":"strong"}]},{"text":"As you merge PRs to master, please be aware of fixes that might need to be applied to Palm. ","type":"text"},{"text":"Let the Build-Test-Release Working Group know ","type":"text","marks":[{"type":"strong"}]},{"text":"if there is a fix to be applied. They will need to be cherry-picked to ship as part of Palm, a.k.a. “","type":"text"},{"text":"backported","type":"text","marks":[{"type":"link","attrs":{"href":"https://openedx.atlassian.net/wiki/spaces/COMM/pages/2065367719"}}]},{"text":"”.","type":"text"}]},{"type":"paragraph","content":[{"text":"I know this gets confusing, but your code going onto master will now automatically be part of the ","type":"text"},{"text":"Quince","type":"text","marks":[{"type":"strong"}]},{"text":" release (due next December). There is a new ","type":"text"},{"text":"Quince wiki page","type":"text","marks":[{"type":"link","attrs":{"href":"https://openedx.atlassian.net/wiki/spaces/COMM/pages/3726802953"}}]},{"text":" for you to note things that will need to be considered when it comes time to release Quince. Please add features, caveats, and concerns to that page. If you are uncertain whether something should be mentioned there, ","type":"text"},{"text":"add it","type":"text","marks":[{"type":"strong"}]},{"text":". Or, talk to the Build-Test-Release WG and we'll figure it out.","type":"text"}]},{"type":"paragraph","content":[{"text":"What’s next? ","type":"text","marks":[{"type":"strong"}]},{"text":"From now until the Palm release date, the Build-Test-Release group will be actively testing the release branch, finding bugs, triaging them, merging fixes to master, and backporting them to Palm. The Build-Test-Release Testing Coordinator will be kicking off this process soon, and they are happy to take volunteers to find and fix bugs. Keep an eye out if you’re interested. Even if you don’t actively participate, you can help this process by promptly reviewing any bugfix PRs that are made in your repositories.","type":"text"}]},{"type":"paragraph","content":[{"text":"Have questions? ","type":"text","marks":[{"type":"strong"}]},{"text":"If you want to know more, we have an ","type":"text"},{"text":"FAQ about the Open edX community releases","type":"text","marks":[{"type":"link","attrs":{"href":"https://openedx.atlassian.net/wiki/spaces/COMM/pages/1331268879/Open%2BedX%2BRelease%2BFAQ"}}]},{"text":". Please reach out if you have any questions.","type":"text"}]},{"type":"paragraph","content":[{"text":"--Ned, on behalf of the community ","type":"text"},{"text":"Build/Test/Release working group","type":"text","marks":[{"type":"link","attrs":{"href":"https://openedx.atlassian.net/wiki/spaces/COMM/pages/1022099494"}}]},{"text":".","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Please x-post the announcement to the DEPR working group in the ","type":"text"},{"text":"#wg-depr-slash-n-burn","type":"text","marks":[{"type":"link","attrs":{"href":"https://openedx.slack.com/archives/CGB0S3L12"}}]},{"text":" channel in the Open edX Slack, so that the DEPR working group can help write release notes of deprecated code in accordance with the ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://openedx.atlassian.net/wiki/spaces/COMM/pages/3397648409"}},{"text":" .","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3e. Get the test process started","type":"text"}]},{"type":"paragraph","content":[{"text":"Reach out to the Build-Test-Release Testing Manager to make sure they’re kicking off the testing process for the newly cut release.","type":"text"}]},{"type":"paragraph","content":[{"text":"When they have a test plan ready, add it to ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://openedx.atlassian.net/wiki/spaces/COMM/pages/3585441835"}},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3f. Get the community-supported distribution release process started","type":"text"}]},{"type":"paragraph","content":[{"text":"Immediately inform the maintainers of community-supported distribution that the upstream release tags have been created and that the distribution release can proceed.","type":"text"}]},{"type":"paragraph","content":[{"text":"As of Palm, the community-supported distribution is ","type":"text"},{"text":"Tutor","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.tutor.overhang.io/"}}]},{"text":". You can reach its maintainers by creating a thread on the forums and tagging ","type":"text"},{"text":"@tutor-maintainers","type":"text","marks":[{"type":"link","attrs":{"href":"https://discuss.openedx.org/g/tutor-maintainers"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"4. Make release-specific changes on the release branch","type":"text"}]},{"type":"paragraph","content":[{"text":"Some changes need to be made directly on the release branch, because they are intended for the release itself, and should not be on master.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Release line","type":"text"}]},{"type":"paragraph","content":[{"text":"In edx-platform/openedx/core/release.py, edit the RELEASE_LINE line to indicate the release:","type":"text"}]},{"type":"codeBlock","content":[{"text":"RELEASE_LINE = \"zebrawood\"","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"5. Update the documentation","type":"text"}]},{"type":"paragraph","content":[{"text":"This will require you to make a few PRs. Have them reviewed from someone else on the Bulid-Test-Release WG.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"5a. Ask Axim to activate hidden release versions of each book","type":"text"}]},{"type":"paragraph","content":[{"text":"File an ","type":"text"},{"text":"Axim systems request","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/openedx/axim-engineering/issues/new/choose"}}]},{"text":" to do the following:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Log into ","type":"text"},{"type":"inlineCard","attrs":{"url":"http://readthedocs.org"}},{"text":" as “openedx-rtd-maintainer”","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Find the following Open edX book projects:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://readthedocs.org/projects/docsopenedxorg/"}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"All books listed in the ","type":"text"},{"text":"intersphinx_mapping","type":"text","marks":[{"type":"code"}]},{"text":" in ","type":"text"},{"text":"conf.py of docs.openedx.org","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/openedx/docs.openedx.org/blob/main/source/conf.py"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"NOTE: ","type":"text","marks":[{"type":"strong"}]},{"text":"All repos in the intersphinx_mapping need to have a book built for the current release in order for the overall ","type":"text"},{"text":"docs.openedx.org","type":"text","marks":[{"type":"link","attrs":{"href":"http://docs.openedx.org"}}]},{"text":" book to build.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Because not all repos are explicitly tagged for release (and thus don’t have an ","type":"text"},{"text":"open-release/release.master","type":"text","marks":[{"type":"code"}]},{"text":" branch), the following procedure must be followed:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For each transitive dependency, figure out the version tag that is part of the current named release (for example for Sumac, we included XBlock v5.1.0 - determined by looking at the edx-platform base requirements, grabbing the package version, and converting it to the tag name)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"When asking Axim to enable the book, they should enable a book off the tag but give it the slug ","type":"text"},{"text":"open-release-TREE-master","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":664,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":721,"alt":"image-20250318-183328.png","id":"226b3c68-0d68-4d07-9081-282f78093b4d","collection":"contentId-19662426","type":"file","height":622}}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Note: the slug rename is a beta feature as of March 2025 and is only enabled on current (as of ","type":"text"},{"type":"date","attrs":{"timestamp":"1742256000000"}},{"text":") intersphinx books. See ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://github.com/readthedocs/readthedocs.org/issues/12057"}},{"text":" - file a support ticket if we need this feature enabled for more books.","type":"text"}]}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For each, find the new release version in the Versions tab, and make it Active. Keep it Hidden until the release is official.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the new release or tag isn’t in the version list:","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"907922ee-b46e-41c6-9847-83416f405cf3"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Then create the branch or tag in the repo to force readthedocs to synchronize the branches as versions.","type":"text"}]}]}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"5b. Add the latest release to the main docs site (This should already be in progress or done as part of the Release Docs process)","type":"text"}]},{"type":"paragraph","content":[{"text":"In ","type":"text"},{"text":"openedx/docs.openedx.org","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/openedx/docs.openedx.org"}}]},{"text":", open a PR and tag someone on BTR for review:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a new directory at ","type":"text"},{"text":"source/community/release_notes/","type":"text","marks":[{"type":"code"}]},{"text":" following the pattern for previous releases. Each directory should have 2 files, feature_release_notes.rst and dev_op_release_notes.rst, along with any other Product-specific release notes. If these files do not exist, copy the directory and files from the previous release, and remove all the text (just leaving the headings and toctree)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update ","type":"text"},{"text":"source/community/release_notes/index.rst","type":"text","marks":[{"type":"code"}]},{"text":", add a new line to the ","type":"text"},{"text":"toctree","type":"text","marks":[{"type":"code"}]},{"text":" so it looks something like this:","type":"text"}]}]},{"type":"listItem","content":[{"type":"codeBlock","attrs":{"language":"diff"},"content":[{"text":".. toctree::\n :maxdepth: 2\n\n Sumac: The Current Release \n Teak: June 2025 Release \n Ulmo: December 2025 Release \n\n.. toctree::\n :maxdepth: 1\n\n old_releases\n named_release_branches_and_tags","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update ","type":"text"},{"text":"source/community/release_notes/named_release_branchs_and_tags.rst","type":"text","marks":[{"type":"code"}]},{"text":" with a new section for the new release.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For example: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://github.com/openedx/docs.openedx.org/pull/693/files"}},{"text":" ","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" Once the PR has been created, contact the ","type":"text"},{"text":"Release Documentation Expert","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/openedx/wg-build-test-release#release-documentation-expert"}}]},{"text":" so that they can review and merge the PR.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"5c. Inform edx-platform developers via the PR template","type":"text"}]},{"type":"paragraph","content":[{"text":"Update the pull request template","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"dd4e00e2-3220-4c17-b191-62f090281426"}}]},{"text":" in the master branch of edx/edx-platform to encourage developers to contribute bugfixes back to both the upcoming & next release branches (see for instance ","type":"text"},{"text":"this PR","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/openedx/edx-platform/pull/32053"}}]},{"text":").","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"6. ","type":"text"},{"text":"Create the release Transifex project","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"3e9c1ac1-fb42-4d32-9004-5c4aae2db6bd"}}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Translations after ","type":"text"},{"text":"OEP-58","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.openedx.org/en/latest/developers/concepts/oep58.html"}}]},{"text":" requires a new Transifex project for each named release. This will ensure the translations sources and code source stay in sync after ","type":"text"},{"text":"main","type":"text","marks":[{"type":"code"}]},{"text":" branches continue to evolve after cutting the release. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Creating multiple projects isn’t ideal and can be revisited if it turns out to harm the Translator Experience.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"6a Double check the ","type":"text"},{"text":"openedx-translations repository branch","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/openedx/openedx-translations"}}]}]},{"type":"paragraph","content":[{"text":"Go to the ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://github.com/openedx/openedx-translations"}},{"text":" repository and ensure it has the proper release branch e.g. ","type":"text"},{"text":"open.release/zebrawood.master","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"6b Clone the ","type":"text"},{"text":"openedx-translations Transifex project","type":"text","marks":[{"type":"link","attrs":{"href":"https://app.transifex.com/open-edx/openedx-translations/content/"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a new Transifex project: ","type":"text"},{"text":"openedx-translations-zebrawood","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add all the languages from the ","type":"text"},{"text":"openex-translatiosn","type":"text","marks":[{"type":"code"}]},{"text":" Transifex project.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"6c Configure the GitHub Transifex App","type":"text"}]},{"type":"paragraph","content":[{"text":"This is a manual step:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to the Zebrawood Transifex project (","type":"text"},{"text":"openedx-translations-zebrawood","type":"text","marks":[{"type":"code"}]},{"text":") configuration settings","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the Integrations tab, click on the GitHub App integration “Install” button","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Allow the integration","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Grant permission to your account","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Grant permission to the ","type":"text"},{"text":"openedx/openedx-translations","type":"text","marks":[{"type":"code"}]},{"text":" repository","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Continue the wizard to configure the project integrations to the following:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select repo step:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Selected repository: ","type":"text"},{"text":"openedx/openedx-translations","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Selected branch: Set it to the release branch e.g. ","type":"text"},{"text":"open.release/zebrawood.master","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select files step:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the path to your YAML configuration file to ","type":"text"},{"text":"transifex.yml","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Sync content step:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"PULL CONTENT: ","type":"text"},{"text":"Fetch content automatically","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"PUSH CONTENT: ","type":"text"},{"text":"100% reviewed","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set “How would you like Transifex to push translations to GitHub?” to ","type":"text"},{"text":"Create a Pull Request","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"No grouping","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add a prefix to the commit message: ","type":"text"},{"text":"chore:","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on the Update Settings button","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Wait for the sync to complete. It takes about an hour.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"2611","text":"☑️","shortName":":ballot_box_with_check:"}},{"text":" Ensure that all the resources has been added.","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"6d Update the Transifex resources names and tags","type":"text"}]},{"type":"paragraph","content":[{"text":"The GitHub Transifex App integeration puts an inconvenient names for resources like ","type":"text"},{"text":"\"translations..frontend-app-something..src-i18n-transifex-input--main\"","type":"text","marks":[{"type":"code"}]},{"text":" instead of ","type":"text"},{"text":"\"frontend-app-something\"","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"This can be fixed with the following command locally:","type":"text"}]},{"type":"codeBlock","content":[{"text":"git clone https://github.com/openedx/openedx-translations.git\ncd openedx-translations\nmkvirtualenv openedx-translations\npip install -r requirements/requirements.txt\n# Dry run the name fix\nmake TRANSIFEX_PROJECT_SLUG='openedx-translations-zebrawood' fix_transifex_resource_names_dry_run\n# If runs without errors, run the actual command:\nmake TRANSIFEX_PROJECT_SLUG='openedx-translations-zebrawood' fix_transifex_resource_names","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"7 Gain LTI Certification for the release","type":"text"}]},{"type":"paragraph","content":[{"text":"Reach out to the LTI working group to certify this release for LTI. See the ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://openedx.atlassian.net/wiki/spaces/~6193b016d5986c006a6460ab/pages/3452600321/How+to+run+the+LTI+Validation+Test?force_transition=403f9580-7954-421a-9b71-8da2cdf771e9"}},{"text":" instructions. ","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"type":"emoji","attrs":{"id":"1f381","text":"🎁","shortName":":gift:"}},{"text":" Tagging a release or release candidate (Tagging Numbered Releases)","type":"text"}]},{"type":"paragraph","content":[{"text":"Releases are tags marking specific versions of all the repos. Take care with the steps to create and tag these. It's surprising, but you have to edit files to refer to the tags before you can create the tag.","type":"text"}]},{"type":"paragraph","content":[{"text":"There are two types of tagged releases:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"the ","type":"text"},{"text":"major release ","type":"text","marks":[{"type":"strong"}]},{"text":"(zebrawood.1) and","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"the ","type":"text"},{"text":"minor (“point”) releases ","type":"text","marks":[{"type":"strong"}]},{"text":"(zebrawood.2, zebrawood.3, and sometimes zebrawood.4+).","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The steps below apply to both major & minor releases, unless they say ","type":"text"},{"text":"(major only)","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"1. Prepare for the tagging a week before it is scheduled….","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"1a. Schedule a release ceremony","type":"text"}]},{"type":"paragraph","content":[{"text":"Schedule a meeting for the day of release, including:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The release manager (you!)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"At least one other Build-Test-Release WG member to check your work, take notes, etc.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If necessary, someone from Axim to grant permissions (see “","type":"text"},{"text":"Overview / Release Manager Permissions","type":"text","marks":[{"type":"underline"}]},{"text":"” section).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Anyone else who wants to listen in!","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Ask someone from Axim to put it on the community working groups calendar.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"1b. Double-check that the test plan is complete (major only)","type":"text"}]},{"type":"paragraph","content":[{"text":"Go to the ","type":"text"},{"text":"Test Plan","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"8bb08890-a792-4ebc-bca6-bb2da5a4cc1b"}}]},{"text":" spreadsheet and check whether testing has been sufficiently completed (to the discretion of the release manager).","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"1c. Double-check that all known issues have been addressed","type":"text"}]},{"type":"paragraph","content":[{"text":"Prior to making a release (major, minor, or even a candidate), it is imperative that all known issues be fixed. You can check at the ","type":"text"},{"text":"GitHub Project board","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/openedx/build-test-release-wg/projects/1"}}]},{"text":" with an appropriate filter such as ","type":"text"},{"text":"“label:bug milestone:lilac.1”","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/openedx/build-test-release-wg/projects/1?card_filter_query=label%3Abug+milestone%3Alilac.1"}}]},{"text":". Over time other labels or milestones may be incorporated, but just keep in mind that issues such as ","type":"text"},{"text":"an uninstallable tag","type":"text","marks":[{"type":"link","attrs":{"href":"https://openedx.atlassian.net/wiki/spaces/COMM/pages/2373255193"}}]},{"text":" are unacceptable.","type":"text"}]},{"type":"paragraph","content":[{"text":"Search for open pull requests against the release branch. For example, for Nutmeg, we would search: ","type":"text"},{"text":"https://github.com/pulls?q=is%3Aopen+is%3Apr+base%3Aopen-release%2Fnutmeg.master+archived%3Afalse","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/pulls?q=is%3Aopen+is%3Apr+base%3Aopen-release%2Fnutmeg.master+archived%3Afalse"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"1d. Create a wiki pages for release process notes","type":"text"}]},{"type":"paragraph","content":[{"text":"Create a child of this page for your own notes: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://openedx.atlassian.net/wiki/spaces/COMM/pages/3734896715"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"Example: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://openedx.atlassian.net/wiki/spaces/COMM/pages/3604807768"}},{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"2. Hold a release tagging ceremony","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"2a. Make a test branch (not a tag!) ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"7c0e01a2-0dd5-44ea-876e-6d4d41d10971"}}]}]},{"type":"paragraph","content":[{"text":"To test the installation, but not yet mark the release, we'll make a test branch. The branch should use your personal prefix (\"you/\"), and be named for the release you are working on, but with an additional .n suffix. Don't use the full release name, or people will find the branch and think it is a release:","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Don’t create a ","type":"text"},{"text":"tag","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" for testing, because once it is pulled by other developers or processes, it becomes very hard to delete - specially on a busy repository such as edx-platform.","type":"text"}]}]},{"type":"codeBlock","content":[{"text":"tag_release --doit --branch --skip-invalid --search-branch open-release/zebrawood.master --override-ref open-release/zebrawood.master you/test/z.1rc1.1","type":"text"}]},{"type":"paragraph","content":[{"text":"The .1 suffix is so that you can make a .2 if something needs to be fixed.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"2c. Test the release one last time","type":"text"}]},{"type":"paragraph","content":[{"text":"At the discretion of the release manager, ","type":"text"},{"text":"consider doing some more testing at this point.","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"331383c4-eaa2-47e9-b0e3-7ddfb3d07f12"}}]}]},{"type":"paragraph","content":[{"text":"Here’s a way you can do that:","type":"text"}]},{"type":"codeBlock","content":[{"text":"tutor config save --set OPENEDX_COMMON_VERSION=you/test/z.1\ntutor local launch","type":"text"}]},{"type":"paragraph","content":[{"text":"Where is the most recent tagged release.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"2d. Create RC or release tags","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Execute this step if, and only if, there were no problems up to it. It is not practical to overwrite a tag on busy git repositories. If there are any errors, a new tag will have to be created.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"For each tagged repo, make tags for the release or release candidate. The tag name is different for the two:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Release candidate: the tag should be ","type":"text"},{"text":"open-release/$RELEASE.XrcY","type":"text","marks":[{"type":"code"}]},{"text":", where X is the number of the release, and Y is the number of the RC.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Release: the tag should be should be ","type":"text"},{"text":"open-release/$RELEASE.X","type":"text","marks":[{"type":"code"}]},{"text":", where X is the number of the release.","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"tag_release --doit --tag --skip-invalid --search-branch open-release/zebrawood.master --override-ref you/test/z.1rc1.1 open-release/zebrawood.1rc1\t\t# for release candidate\n# or:\ntag_release --doit --tag --skip-invalid --search-branch open-release/zebrawood.master --override-ref you/test/z.1.1 open-release/zebrawood.1\t\t\t\t# for release","type":"text"}]},{"type":"paragraph","content":[{"text":"You can delete the test branches you made once the release is marked:","type":"text"}]},{"type":"codeBlock","content":[{"text":"tag_release --doit --branch --skip-invalid --reverse you/test/z.1rc1.1","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"2e. Add the list of tagged repositories to the notes page","type":"text"}]},{"type":"paragraph","content":[{"text":"Just like this: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://openedx.atlassian.net/wiki/spaces/COMM/pages/3604807768/Olive.1#Notes"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"This will give BTR an answer to the question “Which repositories were tagged?”, which will certainly be asked many times.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"2f. You’ve made a release!","type":"text"}]},{"type":"paragraph","content":[{"text":"Congrats, you’ve tagged a new Open edX release!","type":"text"}]},{"type":"paragraph","content":[{"text":"Now, read through the follow-up steps below, and make sure they make sense. In the next ~day you’ll either need to do yourself them or delegate them to others.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"3. Kick off the community-supported distribution release","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"e6883291-411f-4ad5-aef5-4ad0ebb29fe5"}}]}]},{"type":"paragraph","content":[{"text":"Immediately inform the maintainer of community-supported distribution that the upstream release tags have been created and that the distribution release can proceed.","type":"text"}]},{"type":"paragraph","content":[{"text":"As of Palm, the community-supported distribution is Tutor. You can reach its maintainers by creating a thread on the forums and tagging ","type":"text"},{"text":"@tutor-maintainers","type":"text","marks":[{"type":"link","attrs":{"href":"https://discuss.openedx.org/g/tutor-maintainers"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"4. Update the documentation","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"This can happen concurrently with the Tutor Release step.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4a. Ask Axim to un-hide the release versions of each book (major only)","type":"text"}]},{"type":"paragraph","content":[{"text":"File an ","type":"text"},{"text":"Axim systems request","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/openedx/axim-engineering/issues/new/choose"}}]},{"text":" to do the following:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Log into ","type":"text"},{"type":"inlineCard","attrs":{"url":"http://readthedocs.org"}},{"text":" as “openedx-rtd-maintainer”","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Find the following Open edX book projects:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"“","type":"text"},{"text":"Open edX Building and Running a Course","type":"text","marks":[{"type":"link","attrs":{"href":"https://readthedocs.org/projects/open-edx-building-and-running-a-course/"}}]},{"text":"”","type":"text"},{"type":"hardBreak"},{"text":"https://readthedocs.org/projects/open-edx-building-and-running-a-course/","type":"text","marks":[{"type":"link","attrs":{"href":"https://readthedocs.org/projects/open-edx-building-and-running-a-course/versions/"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"”","type":"text"},{"text":"edX Installing, Configuring, and Running” ","type":"text","marks":[{"type":"link","attrs":{"href":"https://readthedocs.org/projects/edx-installing-configuring-and-running/"}}]},{"type":"hardBreak"},{"type":"inlineCard","attrs":{"url":"https://readthedocs.org/projects/edx-installing-configuring-and-running/"}},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"”","type":"text"},{"text":"Open edX Learner's Guide” ","type":"text","marks":[{"type":"link","attrs":{"href":"https://readthedocs.org/projects/open-edx-learner-guide/"}}]},{"type":"hardBreak"},{"type":"inlineCard","attrs":{"url":"https://readthedocs.org/projects/open-edx-learner-guide/"}},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://readthedocs.org/projects/docsopenedxorg/"}},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://readthedocs.org/projects/openedx-oars/"}},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://readthedocs.org/projects/donexblock/"}},{"text":" ","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make the latest release un-hidden.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Keep the last three releases Active and not Hidden. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make the releases older than that Active and Hidden.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4b. Make the new release notes the “latest” (major only)","type":"text"}]},{"type":"paragraph","content":[{"text":"In ","type":"text"},{"text":"openedx/docs.openedx.org","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/openedx/docs.openedx.org"}}]},{"text":", make a PR (","type":"text"},{"text":"example","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/openedx/docs.openedx.org/pull/341"}}]},{"text":") with the following changes, tagging someone on BTR for review:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update ","type":"text"},{"text":"source/conf.py","type":"text","marks":[{"type":"code"}]},{"text":" to point the ","type":"text"},{"text":"latest","type":"text","marks":[{"type":"code"}]},{"text":" release to the latest release page. ","type":"text"}]},{"type":"codeBlock","attrs":{"language":"diff"},"content":[{"text":"rediraffe_redirects = {\n- \"community/release_notes/latest.rst\": \"community/release_notes/yuca.rst\",\n+ \"community/release_notes/latest.rst\": \"community/release_notes/zebrawood.rst\",\n}","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update ","type":"text"},{"text":"source/community/release_notes/index.rst","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Change “Zebrawood: The next release ” to “Zebrawood: The current release ”","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Remove “Yucca: The current release ”","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update ","type":"text"},{"text":"source/community/release_notes/named_release_branches_and_tags.rst","type":"text","marks":[{"type":"code"}]},{"text":" (","type":"text"},{"text":"example","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/openedx/docs.openedx.org/pull/341/files#diff-3d3a55cd0ccf3ab3e10c3993f58a79055665c8c172e7e15e30e9a29bd5393db1"}}]},{"text":")","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add “yucca” to the list at ","type":"text"},{"text":"source/community/release_notes/old_releases.rst","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In ","type":"text"},{"text":"source/index.rst","type":"text","marks":[{"type":"code"}]},{"text":" change “Current Release: Yucca ” to “Current Release: Yucca ”","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4c. Update the release planning wiki pages (major only)","type":"text"}]},{"type":"paragraph","content":[{"text":"Consider “","type":"text"},{"text":"Yucca","type":"text","marks":[{"type":"em"}]},{"text":"” to be the release you are cutting no\"w, and “","type":"text"},{"text":"Zebrawood","type":"text","marks":[{"type":"em"}]},{"text":"” to be the next release after that (six months from now).","type":"text"}]},{"type":"paragraph","content":[{"text":"Under ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://openedx.atlassian.net/wiki/spaces/COMM/pages/13205845"}},{"text":" …","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rename ","type":"text"},{"text":"Upcoming Release: Yucca","type":"text","marks":[{"type":"underline"}]},{"text":" to simply ","type":"text"},{"text":"Yucca","type":"text","marks":[{"type":"underline"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Move ","type":"text"},{"text":"Yucca","type":"text","marks":[{"type":"underline"}]},{"text":" under ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://openedx.atlassian.net/wiki/spaces/COMM/pages/3734863933"}},{"text":" .","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"(Note: There should still be a ","type":"text"},{"text":"Next Release: Zebrawood","type":"text","marks":[{"type":"underline"}]},{"text":" page underneath ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://openedx.atlassian.net/wiki/spaces/COMM/pages/13205845"}},{"text":" )","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Finally, update ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://openedx.atlassian.net/wiki/spaces/COMM/pages/3613392957"}},{"text":" .","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"4d. Inform edx-platform developers via the PR template (major only)","type":"text"}]},{"type":"paragraph","content":[{"text":"Update the ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"dd4e00e2-3220-4c17-b191-62f090281426"}}]},{"text":"Confluence page","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"dd4e00e2-3220-4c17-b191-62f090281426"}},{"type":"link","attrs":{"href":"https://openedx.atlassian.net/wiki/spaces/COMM/pages/4248436737"}}]},{"text":" linked from a pull request template","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"dd4e00e2-3220-4c17-b191-62f090281426"}}]},{"text":" in the master branch of edx/edx-platform to encourage developers to contribute bugfixes back to the latest release branch. Drop any mention of the previous release, which is now unsupported.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"5. Announce to the community","type":"text"}]},{"type":"paragraph","content":[{"text":"Create a topic in the ","type":"text"},{"text":"Announcements - Releases category","type":"text","marks":[{"type":"link","attrs":{"href":"https://discuss.openedx.org/c/announcements/releases"}}]},{"text":" on ","type":"text"},{"text":"discuss.openedx.org","type":"text","marks":[{"type":"link","attrs":{"href":"http://discuss.openedx.org"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Change the topic line in the ","type":"text"},{"text":"#ops","type":"text","marks":[{"type":"code"}]},{"text":" channel in Slack.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"5a. Announce the new named release (major only)","type":"text"}]},{"type":"paragraph","content":[{"text":"Make sure a blog post gets published. ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"bc7117f3-f7bb-4405-8507-c85e505bc58e"}}]}]},{"type":"paragraph","content":[{"text":"Update the ","type":"text"},{"text":"Support Windows chart","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.google.com/spreadsheets/d/11DheEtMDGrbA9hsUvZ2SEd4Cc8CaC4mAfoV8SVaLBGI/edit#gid=195838733"}}]},{"text":". For example: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://github.com/openedx/repo-tools/pull/325/files"}},{"text":". Be sure to read the top of barcalendar.py to understand how to update the chart.","type":"text"}]},{"type":"paragraph","content":[{"text":"Have the 2U contact announce the release within 2U. Send an email to ","type":"text"},{"text":"edx-tech-announce@2u.com","type":"text","marks":[{"type":"link","attrs":{"href":"mailto:edx-tech-announce@2u.com"}}]},{"text":", for example:","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"The Olive release of the Open edX platform was officially released on Monday 12/12! Thanks for everything you did to help make it happen. ","type":"text"}]},{"type":"paragraph","content":[{"text":"This is not the end of Olive: the open-release/olive.master branches are still accepting fixes. When fixing problems in your normal course of work, please consider whether it makes sense to backport it to Olive.","type":"text"}]},{"type":"paragraph","content":[{"text":"I know the release process can be a bit mysterious:","type":"text"}]},{"type":"paragraph","content":[{"text":"- The open-release/olive.master branches were created in 44 repos on October 11th.","type":"text"}]},{"type":"paragraph","content":[{"text":"- Since then, all work on master or main branches has only been part of Olive if it was explicitly cherry-picked or backported.","type":"text"}]},{"type":"paragraph","content":[{"text":"- The master or main work since October 11th has been the start of the Palm release that will happen next June.","type":"text"}]},{"type":"paragraph","content":[{"text":"If you have questions, we have an FAQ wiki page about Open edX releases, and you can always reach out to us in the #interest-openedx 2U Slack channel.","type":"text"}]},{"type":"paragraph","content":[{"text":"Thanks again for helping make the Open edX platform available around the world to the thousands of sites using it for their online education!","type":"text"}]},{"type":"paragraph","content":[{"text":"--Ned.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"6. Keep an eye out for bugfixes that should be backported","type":"text"}]},{"type":"paragraph","content":[{"text":"Over the next two weeks or so, keep an eye out for bugfixes going into master, so that important bugfixes also go into the release master branch. These will become part of the following minor release.","type":"text"}]},{"type":"paragraph","content":[{"text":"Generally, zebrawood.3 is the final minor release, but in cases where we have important follow-up fixes, you can tag zebrawood.4, etc.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"7.","type":"text"},{"text":" (For the final release)","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"56eaf4ba-107b-43a0-af81-3981728a41d9"}}]},{"text":" Check that release changes made it to master","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"I’m not sure that this step makes sense still -Kyle","type":"text"}]}]},{"type":"paragraph","content":[{"text":"During the stabilization of the release, you may have changes made directly on the open-release/zebrawood.master branch. Take a look at what's there, and compare to master to be sure all the changes end up on master also. Keep in mind that there are a few changes on the release branch that should only be on the release branch (RELEASE_LINE for example).","type":"text"}]},{"type":"codeBlock","content":[{"text":"# gittreeif is a handy function from https://github.com/nedbat/dot/blob/master/.bashrc\nGIT_PAGER=cat gittreeif origin/open-release/hawthorn.master log origin/open-release/zebrawood.master ^origin/master","type":"text"}]}],"version":1}

Browser not supported