Skip to content

Commit 7b22f0c

Browse files
Rename release blockers
1 parent 7f6f3cc commit 7b22f0c

File tree

3 files changed

+15
-15
lines changed

3 files changed

+15
-15
lines changed

index.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ for your topic of interest. You can also use the search function in the top-left
4444
triage/about
4545
triage/workflow
4646
triage/guidelines
47-
triage/release_blockers
47+
triage/release_priorities
4848
triage/sprint_instructions
4949

5050
.. toctree::

triage/release_blockers.rst renamed to triage/release_priorities.rst

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,30 +1,30 @@
1-
.. _doc_bug_triage_release_blockers:
1+
.. _doc_bug_triage_release_priorities:
22

3-
Release blocker tracking
4-
========================
3+
Release priority tracking
4+
=========================
55

6-
Release blockers are issues that we aim to fix before we release the
6+
Release priorities are issues that we aim to fix before we release the
77
next version. There are a few different things to consider when
8-
determining if an issue is a release blocker or not. Generally any bug
8+
determining if an issue is a release priority or not. Generally any bug
99
that has appeared during the current cycle should be considered release
10-
blockers (and assigned the “regression” label), if the issue isn’t
10+
priorities (and assigned the “regression” label), if the issue isn’t
1111
considered critical it will marked as not critical, see
1212
`severity <#severity>`__ below.
1313

14-
Issues with new features can also be considered release blockers. This
14+
Issues with new features can also be considered release priorities. This
1515
is because once a feature is part of a released version (and isn’t
1616
considered experimental) it is much harder to change how that feature
1717
works without breaking compatibility (see the `release policy page <https://docs.godotengine.org/en/latest/about/release_policy.html#what-are-the-criteria-for-compatibility-across-engine-versions>`__).
1818
This means that fixing issues, especially minor issues that wouldn’t be
1919
critical otherwise, should be done early to avoid compatibility issues
2020
later.
2121

22-
Release blockers have their own project, `4.x Release Blockers <https://github.com/orgs/godotengine/projects/61>`__.
22+
Release priorities have their own project, `4.x Release Priorities <https://github.com/orgs/godotengine/projects/61>`__.
2323

2424
Severity
2525
--------
2626

27-
Release blockers should also be assigned a severity, this is usually
27+
Release priorities should also be assigned a severity, this is usually
2828
handled by either the production team or the specific :ref:`area maintainers <doc_areas>`, so this is only a rough
2929
outline to use to assign this if you are able:
3030

triage/workflow.rst

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ Triage checklist
2323
author to add the missing information.
2424
- `Check for duplicates <#check-for-duplicates>`__.
2525
- Check if the issue is a recent regression. If it is, add it to the
26-
:ref:`release blocker tracker <doc_bug_triage_release_blockers>` and
26+
:ref:`release priorities <doc_bug_triage_release_priorities>` and
2727
mark it as a “regression”.
2828
- Add initial labels.
2929
- `Assign a milestone <#assigning-milestones>`__ if relevant.
@@ -78,7 +78,7 @@ having tested development versions) please either ask the author to test
7878
with a stable version or test the bug yourself. If it *doesn’t* occur on
7979
a past release it is considered a regression and should be tagged with
8080
the “regression” label, and should also be added to the “4.x Release
81-
Blockers” project. See :ref:`doc_bug_triage_release_blockers` for details.
81+
Priorities” project. See :ref:`doc_bug_triage_release_priorities` for details.
8282

8383
Try to tag an issue as specifically as possible, adding “needs testing”
8484
and “needs work” if necessary. Don’t worry about misidentifying issues,
@@ -104,20 +104,20 @@ Note that this is for assigning milestones to *open* issues, please see
104104
and milestones.
105105

106106
Below is an outline of the different milestones we use, but as a general
107-
rule you can assume that issues that aren’t release blockers, or
107+
rule you can assume that issues that aren’t release priorities, or
108108
specific to ``3.x``, shouldn’t have milestones assigned.
109109

110110
For the ``master`` branch:
111111

112112
* ``4.x``: For Godot 4 in general, i.e. the ``master`` branch. We do not use the ``4.x`` milestone on issues, issues with no milestone are assumed to be relevant for the current development cycle.
113-
* *The current development version*: Should be assigned to issues that are :ref:`release blockers <doc_bug_triage_release_blockers>`, or otherwise prioritized for the current version.
113+
* *The current development version*: Should be assigned to issues that are :ref:`release priorities <doc_bug_triage_release_priorities>`, or otherwise prioritized for the current version.
114114
* *The next release version*: When we enter feature freeze we usually create a new milestone used for PRs that are approved but won’t make it into the current release, this milestone is not used for issues.
115115
* *Older Godot 4 versions*: This is used for issues that are only relevant for this specific version (or older versions), but not any newer version. An example of this would be an issue that was solved in ``4.5`` as part of an enhancement, but that enhancement cannot be cherry-picked for ``4.4`` and a separate issue is necessary to track the specific solution for ``4.4`` (and older, if relevant). For such issues it can also be relevant to add “[4.4]” at the beginning of the issue title to help clarify it is specific to this version.
116116

117117
For Godot 3:
118118

119119
* ``3.x``: For the ``3.x`` branch in general. Used for issues that are only relevant for the ``3.x`` version, and occurs on the current development version of ``3.x``. For these issues it can also help to add “[3.x]” at the beginning of the issue title to help identifying the issue.
120-
* Other Godot 3 milestones work the same way as for the ``master`` branch, except we do not track release blockers for ``3.x``.
120+
* Other Godot 3 milestones work the same way as for the ``master`` branch, except we do not track release priorities for ``3.x``.
121121

122122
Testing an Issue
123123
----------------

0 commit comments

Comments
 (0)