Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Motivation
Github recently added support for Issue forms, which can help guide the creation of issues for adopters and developers to provide the critical information needed to diagnose issues. These have recently been adopted by the Swift project too, from which our templates take much inspiration.
When using issue forms (and templates in general) it also provides the filer with a choice of what kind of issue it is, and can automatically add appropriate labels based on kind and apply the
status/triage
label.Finally the page that displays the choice of issue templates can be further extended to provide links to other useful external resources.
Note that it is still possible to create an issue from a blank slate if none of the options suit the adopter.
Check out the "New issue" page on apple/swift to see all these features combined and in action1.
Modifications
kind/bug
,status/triage
.kind/support
,status/triage
.kind/feature
,status/triage
.kind/enhancement
,status/triage
.Result
More guided process when filing issues and surfaces other relevant resources.
Test Plan
None.
Footnotes
https://github.com/apple/swift/issues/new/choose ↩