Formatted for easier scanning (nested bullet points); clarified some details
diff --git a/HandlingIssues.md b/HandlingIssues.md
index 3cb7778..cbadaf3 100644
--- a/HandlingIssues.md
+++ b/HandlingIssues.md
@@ -2,39 +2,45 @@
# Issue States
-Any issue must be in one of the following five states. Project contributors move issues from one state to another by doing things. The intent behind these explicit states is to describe the (minimum) next steps required to bring the issue to resolution. Issues may move between states in any order, as dictated by the needs of the particular issue.
+Any issue must be in one of the following states. Project contributors move issues from one state to another. The intent behind these explicit states is to describe the (minimum) next steps required to bring the issue to resolution. Issues may move between states in any order, as dictated by the needs of the particular issue.
-New
+### New
- The issue has been filed.
- May not be correctly formatted (title, etc).
-- To transition from this state, someone must clean up the issue report and optionally cc people who might best investigate or fix it.
+- To transition from this state, someone must clean up the issue report and optionally CC people who might best investigate or fix it.
-Needs Investigation
-- Is correctly formatted (the title has a path prefix, and the body describes the issue).
+### Needs Investigation
+- Is correctly formatted.
+ - The title has a path prefix.
+ - The body describes the issue.
+- Has a milestone.
- Has the label `NeedsInvestigation`.
-- May have the label `WaitingForInfo` if the investigator is waiting for more information from someone (e.g., the issue reporter).
-- To transition from this state, someone must examine it and confirm that it is a valid issue and not a duplicate of an existing issue.
+ - May also have the label `WaitingForInfo` if the investigator is waiting for more information from someone (e.g., the issue reporter).
+- To transition from this state, someone must examine the issue and confirm that it is valid and not a duplicate of an existing issue.
-Needs Decision
-- The issue is real, but we're not sure what action to take. Feedback is required from experts, contributors, and/or the community before a fix can be made.
-- Note that the majority of issues will never transition to this state, as most of the time the decision is an obvious "Yes, this should be fixed."
+### Needs Decision
+- The issue is real, but we're not sure what action to take.
+ - The issue can be addressed in Go 1.
+ - Feedback is required from experts, contributors, and/or the community before a fix can be made.
+ - Note that the majority of issues will never transition to this state, as most of the time the decision is an obvious “Yes, this should be fixed.”
+- Has a milestone.
- Has the label `NeedsDecision`.
-- Has a milestone.
-- May have the label `Blocked` if forward progress cannot be made pending the resolution of another issue or the release of a future version of Go (an accompanying comment should explain the blockage).
-- May have the label `WaitingForInfo`.
+ - May have the label `WaitingForInfo`.
+ - May have the label `Blocked` if forward progress depends upon the resolution of another issue or the release of a future version of Go. An accompanying comment should explain the blockage.
+ - Must not have the label `Go2`. (Those issues are handled separately.)
- To transition from this state, someone must decide how the issue is to be resolved.
-- If the decision is complicated, the issue may be given a `Proposal` label and the issue remains in this state until the proposal process is complete.
+ - If the decision is complicated, the issue may be given a [`Proposal`](https://github.com/golang/proposal/) label. The issue remains in this state until the proposal process is complete, and moves to `NeedsFix` if approved.
-Needs Fix
+### Needs Fix
- The path to resolution is known, but the work has not been done.
-- Has the label `NeedsFix`.
- Has a milestone.
-- May have the labels `Blocked` or `WaitingForInfo`.
+- Has the label `NeedsFix`.
+ - May have the labels `Blocked` or `WaitingForInfo`.
- To transition from this state, someone must do the work to fix the issue.
-Fixed
+### Fixed
- The issue is resolved. No further attention is required.
-- Is closed.
+- The issue is closed.
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.
@@ -43,13 +49,9 @@
At any state (except New) the issue may be assigned to someone.
Unassigned issues are considered available for anyone to address.
-# Exceptions
-
-Go2 issues are not labeled with any `Needs` state and are handled separately.
-
-[Proposals](https://github.com/golang/proposal/) follow a separate process. Once approved they transition to Needs Fix.
# Milestones
+
Milestones describe the timeline for issue resolution.
- Go1.x.y
