Skip to content

Commit ab13538

Browse files
ianlancetaylorgopherbot
authored andcommitted
HandlingIssues: add notes about proposal process
Including plans for handling language changes. For golang/go#65660 Change-Id: I0fe3cf1ceb8100ce89ddf6271701a2bb906678c3 Reviewed-on: https://go-review.googlesource.com/c/wiki/+/603401 Auto-Submit: Ian Lance Taylor <iant@golang.org> Commit-Queue: Ian Lance Taylor <iant@golang.org> Reviewed-by: Ian Lance Taylor <iant@golang.org>
1 parent f365326 commit ab13538

File tree

1 file changed

+21
-4
lines changed

1 file changed

+21
-4
lines changed

HandlingIssues.md

+21-4
Original file line numberDiff line numberDiff line change
@@ -51,6 +51,9 @@ Any issue must be in one of the following states. Project contributors move issu
5151
- The issue is resolved. No further attention is required.
5252
- The issue is closed.
5353

54+
#### Proposal
55+
- See below for the proposal process.
56+
5457
Issues move from one state to another where appropriate. For example, a contributor may file an issue, assign it to themselves, and immediately apply the `NeedsFix` label. Or, an issue may go from `NeedsDecision` to `NeedsFix`, only to later move back to `NeedsDecision` as complexities arise.
5558

5659
An issue may be closed at any time, with a comment to indicate the reason for closure ("fixed by …", "duplicate of …", "working as intended", etc).
@@ -91,11 +94,25 @@ Milestones describe the timeline for issue resolution.
9194

9295
For gccgo issues.
9396

94-
- Go2
95-
96-
Deferred until Go 2.
97-
9897
Additional milestones may be used to manage specific project work.
9998

10099
The label "Soon" is used independently of milestones to indicate that the issue is time-sensitive.
101100

101+
## Proposals
102+
103+
Changes to the language or the standard library API go through the
104+
[proposal process](https://go.dev/s/proposal-process).
105+
In the issue tracker a proposal will normally have the `Proposal`
106+
label and be in the `Proposal` milestone.
107+
108+
A proposal that suggests a backward-incompatible change to a library
109+
will have the `v2` label, meaning that it can only be adopted if there
110+
is a v2 version of the package (or, in the distant future, a v3
111+
version).
112+
113+
A proposal that suggests a change to the language should have the
114+
`LanguageChange` label.
115+
Minor language changes are handled as part of the regular proposal
116+
process.
117+
Larger language changes are handled by a language review process;
118+
those issues should have a `LanguageChangeReview` label.

0 commit comments

Comments
 (0)