Skip to content

Milestone and Release workflow

Matthew Taylor edited this page Oct 2, 2017 · 6 revisions

Scratch is released on a monthly schedule.

Milestones

A milestone captures the new features and bugs that are expected to be implemented for a particular release. The date associated with a milestone is the date when we freeze the code. When we freeze, we stop merging new changes to allow for testing of the milestone. Following the freeze there is a week or two of testing to make sure everything is ok before we merge the changes into the Master branch. During this time PRs for the next milestone will be left unmerged to allow for testing of the current milestone.

Milestones are shared across many repositories and projects, both public and private.

Releases

A release happens when we publish all the changes in a milestone to Scratch, usually a week or so after the freeze date. How long after the freeze exactly depends on how long it takes to test everything, and sometimes external factors – such as a big event, like a Scratch conference – will play a role in deciding exactly when to deploy.

Releases happen across many repositories in the Scratch project, both public and private. Even if all the features and bugs associated with this particular public repository (scratch-www) look ready to go, it won't be released until everything else in our other repositories is ready too.

Localization of Releases

Internally we update translations from the Transifex server on a nightly basis. When we build the site for release, the most recent translations will be included. Check out our Localization Guide for more info on that process.

Hotfixes

Sometimes it is necessary to release a particular feature on a specific date out of sync from a milestone/release. A hotfix will generally only include the pull requests related to the specific feature/critical bug fix.