You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/release/developer-checklist.md
+10-10Lines changed: 10 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,14 +4,14 @@ This checklist is for developers. It summarizes what you (as a contributor/featu
4
4
- main → beta
5
5
- beta → release
6
6
7
-
For the full release-driver process (branch locks, announcements, publishing), see [Release → Release Process](../ci/RELEASE.md).
7
+
For the full release-driver process (branch locks, announcements, publishing), see [Release → Release Process](../release/RELEASE.md).
8
8
9
9
## Ongoing (between merges)
10
10
11
11
Do these as part of regular development:
12
12
13
13
- Identify potential uplifts early
14
-
- Add risk and user impact notes to the issue/PR; ensure the fix lands on `main` and bakes on Daily first — see [Uplifts](../ci/RELEASE.md#uplifts) and [Uplift Criteria](../ci/RELEASE.md#uplift-criteria)
14
+
- Add risk and user impact notes to the issue/PR; ensure the fix lands on `main` and bakes on Daily first — see [Uplifts](../release/RELEASE.md#uplifts) and [Uplift Criteria](../release/RELEASE.md#uplift-criteria)
15
15
- Strings and translations
16
16
- Avoid late string changes; if unavoidable, keep them small, so translators can catch up
17
17
- Prefer not changing localizable strings for uplifts
@@ -29,7 +29,7 @@ Do these as part of regular development:
29
29
## Before main → beta (developer responsibilities)
30
30
31
31
> [!NOTE]
32
-
> A one-week [Soft Freeze](../ci/RELEASE.md#soft-freeze) occurs before merging `main` into `beta`.
32
+
> A one-week [Soft Freeze](../release/RELEASE.md#soft-freeze) occurs before merging `main` into `beta`.
33
33
34
34
During soft freeze:
35
35
- Avoid landing risky code changes
@@ -38,10 +38,10 @@ During soft freeze:
38
38
Goal: Changes on `main` are safe to expose to a broader audience.
39
39
40
40
- Feature flags
41
-
- Ensure flags match the [rules for beta](../ci/RELEASE.md#feature-flags)
41
+
- Ensure flags match the [rules for beta](../release/RELEASE.md#feature-flags)
42
42
- New features are disabled by default unless explicitly approved for beta
43
43
- Not-ready features must be disabled
44
-
- Prepare and merge a PR on `main` with necessary flag changes (before merge day)
44
+
- Prepare and merge a PR on `main` with necessary flag changes (before soft freeze starts)
45
45
- Translations
46
46
- Ensure translation updates needed for your features are merged to `main`
47
47
- If no Weblate PR is pending, trigger one and help review it (fix conflicts if needed)
@@ -51,10 +51,10 @@ Goal: Changes on `main` are safe to expose to a broader audience.
51
51
Goal: Changes on `beta` are safe for general availability.
52
52
53
53
- Feature flags
54
-
- Verify flags align with [rules for release](../ci/RELEASE.md#feature-flags)
54
+
- Verify flags align with [rules for release](../release/RELEASE.md#feature-flags)
55
55
- Features are disabled unless explicitly approved for release
56
56
- Not-ready features remain disabled
57
-
- If changes are required, open a PR on `main` and request uplift to `beta` following the criteria in [Uplift Criteria](../ci/RELEASE.md#uplift-criteria)
57
+
- If changes are required, open a PR on `main` and request uplift to `beta` following the criteria in [Uplift Criteria](../release/RELEASE.md#uplift-criteria)
58
58
- Translations
59
59
- No new string changes at this stage; confirm your changes don’t introduce them
60
60
- Stability checks you can influence
@@ -67,11 +67,11 @@ Goal: Changes on `beta` are safe for general availability.
67
67
Paste the following snippet into your PR description to help reviewers and release drivers verify readiness for merge:
68
68
69
69
```markdown
70
-
-[ ] Feature flags set according to target branch rules ([beta](../ci/RELEASE.md#feature-flags) / [release](../ci/RELEASE.md#feature-flags))
70
+
-[ ] Feature flags set according to target branch rules ([beta](../release/RELEASE.md#feature-flags) / [release](../release/RELEASE.md#feature-flags))
71
71
-[ ] Tests added/updated; CI green on affected modules
72
72
-[ ] No new localizable strings (or justified and coordinated)
73
73
-[ ] Translations accounted for (Weblate PR merged or not required)
74
-
-[ ] Uplift label and risk/impact notes added if proposing uplift ([criteria](../ci/RELEASE.md#uplift-criteria))
74
+
-[ ] Uplift template with risk/impact notes filled out if proposing uplift ([criteria](../release/RELEASE.md#uplift-criteria))
75
75
```
76
76
77
77
## After merges (what developers should verify)
@@ -81,5 +81,5 @@ Paste the following snippet into your PR description to help reviewers and relea
81
81
- Be prepared to propose/prepare a hotfix via the uplift process if necessary
82
82
83
83
> [!NOTE]
84
-
> Merge-day coordination (branch locks, Matrix announcements, running scripts) is handled by release drivers. See [Merge Process](../ci/RELEASE.md#merge-process) for details.
84
+
> Merge-day coordination (branch locks, Matrix announcements, running scripts) is handled by release drivers. See [Merge Process](../release/RELEASE.md#merge-process) for details.
0 commit comments