Skip to content

Commit 7e0c9e8

Browse files
authored
Update for our new 4 week release plan
1 parent 30ec252 commit 7e0c9e8

File tree

1 file changed

+26
-24
lines changed

1 file changed

+26
-24
lines changed

CONTRIBUTING.md

Lines changed: 26 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -168,34 +168,36 @@ issues in some way in a timely manner (typically in less than one
168168
business day, definitely no more than a week). We also answer
169169
questions that reach us in other ways, e.g. Twitter.
170170

171-
### Iteration/milestone cycle
171+
For pull requests, we aim to review any externally contributed PR no later
172+
than the next sprint from when it was submitted (see
173+
[Release Cycle](#release-cycle) below for our sprint schedule).
174+
175+
### Release cycle
176+
177+
Planning is done as two week sprints. We start a sprint every other Wednesday.
178+
You can look at the newest
179+
[milestone](https://github.com/Microsoft/vscode-python/milestones) to see when
180+
the current sprint ends. All
181+
[P0](https://github.com/Microsoft/vscode-python/labels/P0) issues are expected
182+
to be fixed in the current sprint, else the next release will be blocked.
183+
[P1](https://github.com/Microsoft/vscode-python/labels/P1) issues are a
184+
top-priority in a sprint, but if they are not completed they will not
185+
block a release. All other issues are considered best-effort for that
186+
sprint.
172187

173-
The extension aims to do a new release every month. A
188+
The extension aims to do a new release every four weeks (two sprints). A
174189
[release plan](https://github.com/Microsoft/vscode-python/labels/release%20plan)
175190
is created for each release to help track anything that requires a
176-
person to do (long term this project aims to automate as much of the
177-
development process as possible). The current issues being worked on
178-
for a release are tracked in a
179-
[milestone](https://github.com/Microsoft/vscode-python/milestones)
180-
(which is actively updated as plans change). All
181-
[P0](https://github.com/Microsoft/vscode-python/labels/P0) are expected to
182-
be fixed in a milestone, else the release will be blocked.
183-
[P1](https://github.com/Microsoft/vscode-python/labels/P1) issues are a
184-
top-priority in a milestone, but if they are not completed they will not
185-
block a milestone. All other issues are considered best-effort for that
186-
milestone.
187-
188-
The overall schedule is to release the same week as VS Code.
189-
We do bugfix-only releases between scheduled releases as necessary, but
190-
otherwise we aim to do one release a month.
191+
person to do (long-term this project aims to automate as much of the
192+
development process as possible).
191193

192194
All development is actively done in the `master` branch of the
193195
repository. It is what allows us to have a
194196
[development build](#development-build) which is expected to be stable at
195-
all times. We do keep the most recent release as a branch in case the
196-
need for a bugfix release arises. But once a new release is made we
197-
delete the older release branch (all releases are appropriately
198-
tagged, so no history is lost).
197+
all times. Once we reach a release candidate, it becomes
198+
our [release branch](https://github.com/Microsoft/vscode-python/tree/release).
199+
At that point only what is in the release branch will make it into the next
200+
release.
199201

200202
### Issue triaging
201203

@@ -238,10 +240,10 @@ auto-updates and thus there is no need to track its version
238240
number for backwards-compatibility. As such, the major version
239241
is the current year, the minor version is the month when feature
240242
freeze was reached, and the micro version is how many releases there
241-
have been since that feature freeze (starting at 0). For example
243+
have been in that month (starting at 0). For example
242244
the release made when we reach feature freeze in July 2018
243-
would be `2018.7.0`, and if a second release was necessary to fix a
244-
critical bug it would be `2018.7.1`.
245+
would be `2018.7.0`, and if there is a second release in that month
246+
it would be `2018.7.1`.
245247

246248
## Releasing
247249

0 commit comments

Comments
 (0)