Clarify language and formatting; remove redundancies

This commit is contained in:
Andrew David Wong 2023-04-07 15:14:50 -07:00
parent a02ad110c5
commit 461aefcad0
No known key found for this signature in database
GPG Key ID: 8CE137352A019A17

View File

@ -131,24 +131,22 @@ The issue tracker has several
should be assigned to **exactly one** milestone. The issue tracker does not should be assigned to **exactly one** milestone. The issue tracker does not
allow assigning an issue to more than one milestone. If an issue is already allow assigning an issue to more than one milestone. If an issue is already
assigned to a milestone, assigning it to a different one will *replace* the assigned to a milestone, assigning it to a different one will *replace* the
existing milestone assignment. No open issue should lack a milestone existing milestone assignment.
assignment.
Most milestones correspond to specific Qubes OS releases. A bug report assigned Most milestones correspond to specific Qubes OS releases. For **bug reports**,
to a release milestone indicates an alleged bug *in* that Qubes OS release. A the milestone designates the *earliest supported release* in which that bug is
task or enhancement assigned to a release milestone indicates that the goal is known to exist. For **enhancements** and **tasks**, the milestone indicates
to implement or do that thing *in* or *for* that Qubes OS release. that the goal is to implement or do that thing *in* or *for* that release.
The `Release TBD` (To Be Determined) milestone is for enhancements or tasks The `Release TBD` (To Be Determined) milestone is for **enhancements** or
that will be specific to a Qubes OS release but have yet to be assigned to a **tasks** that will be specific to a Qubes OS release but have yet to be
specific release milestone. Bug reports should never be assigned to this assigned to a specific release milestone. **Bug reports** should never be
milestone, because every bug is a problem or defect in something that already assigned to the `Release TBD` milestone, because every bug is a problem or
exists. defect in something that already exists.
The `Non-release` milestone is for issues that are independent of the Qubes OS The `Non-release` milestone is for issues that are independent of the Qubes OS
release cycle, including (but not limited to) website, documentation, and release cycle, including (but not limited to) most website, documentation, and
project management issues. These are issues that will never be assigned to a project management issues.
specific Qubes OS release milestone.
### Projects ### Projects