Merge pull request #1649 from aws/kellertk/issue-templates

feat: Standardize issue templates for discussions

Author: vudh1

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -1,61 +1,48 @@
-name: "\U0001F41B Bug Report"
-description: File a bug report
+---
+name: "🐛 Bug Report"
+description: Report a bug
 title: "(short issue description)"
 labels: [bug, needs-triage]
+assignees: []
 body:
-  - type: checkboxes
-    id: terms
-    attributes:
-      label: Documentation
-      description: Please confirm.
-      options:
-        - label: I've gone though the [API reference](https://docs.aws.amazon.com/sdk-for-go/v2/api/)
-          required: true
-        - label: I've checked [AWS Forums](https://forums.aws.amazon.com) and [StackOverflow](https://stackoverflow.com/questions/tagged/aws-sdk-go) for answers
-          required: true
-        - label: I've searched for [previous similar issues](https://github.com/aws/aws-sdk-go-v2/issues) and didn't find any solution
-          required: true
-
   - type: textarea
     id: description
     attributes:
       label: Describe the bug
-      description: A clear and concise description of what the bug is.
+      description: What is the problem? A clear and concise description of the bug.
     validations:
       required: true
-
   - type: textarea
     id: expected
     attributes:
-      label: Expected behavior
+      label: Expected Behavior
       description: |
-        Tell us what should happen.
+        What did you expect to happen?
     validations:
       required: true
-
   - type: textarea
     id: current
     attributes:
-      label: Current behavior
+      label: Current Behavior
       description: |
-        Tell us what happens instead of the expected behavior.
-        Include full errors, uncaught exceptions, stack traces, and relevant logs.
-        To turn on SDK logging, follow instructions here: http://docs.aws.amazon.com/sdk-for-java/v2/developer-guide/java-dg-logging.html
-        If service responses are relevant, please include wirelogs.
+        What actually happened?
+        
+        Please include full errors, uncaught exceptions, stack traces, and relevant logs.
+        If service responses are relevant, please include wire logs.
     validations:
-        required: true
-
+      required: true
   - type: textarea
     id: reproduction
     attributes:
-      label: Steps to Reproduce
+      label: Reproduction Steps
       description: |
         Provide a self-contained, concise snippet of code that can be used to reproduce the issue.
         For more complex issues provide a repo with the smallest sample that reproduces the bug.
+        
         Avoid including business logic or unrelated code, it makes diagnosis more difficult.
+        The code sample should be an SSCCE. See http://sscce.org/ for details. In short, please provide a code sample that we can copy/paste, run and reproduce.
     validations:
       required: true
-
   - type: textarea
     id: solution
     attributes:
@@ -64,6 +51,14 @@ body:
         Suggest a fix/reason for the bug
     validations:
       required: false
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional Information/Context
+      description: |
+        Anything else that might be relevant for troubleshooting this bug. Providing context helps us come up with a solution that is most useful in the real world.
+    validations:
+      required: false
 
   - type: input
     id: Go-sdk-version

.github/ISSUE_TEMPLATE/config.yml

@@ -1 +1,5 @@
-blank_issues_enabled: false
+blank_issues_enabled: false
+contact_links:
+  - name: 💬 General Question
+    url: https://github.com/aws/aws-sdk-go-v2/discussions/categories/q-a
+    about: Please ask and answer questions as a discussion thread

.github/ISSUE_TEMPLATE/documentation.yml

@@ -1,24 +1,26 @@
-name: "\U0001F4DD Documentation Report"
-description: Suggest incorrect/improvement in documentation
+---
+name: "📕 Documentation Issue"
+description: Report an issue in the API Reference documentation or Developer Guide
 title: "(short issue description)"
 labels: [documentation, needs-triage]
+assignees: []
 body:
   - type: textarea
     id: description
     attributes:
-      label: Describe the issue with documentation
-      description: A clear and concise description of what the issue is.
+      label: Describe the issue
+      description: A clear and concise description of the issue.
     validations:
       required: true
 
   - type: textarea
-    id: solution
+    id: links
     attributes:
-      label: Suggestion
+      label: Links
       description: |
-        Suggest a fix,improvement or addition you'd like to see in the documentation.
+        Include links to affected documentation page(s).
     validations:
-      required: false
+      required: true
 
   - type: input
     id: Go-sdk-version

.github/ISSUE_TEMPLATE/feature-request.yml

@@ -1,7 +1,9 @@
-name: "\U0001F680 Feature Request"
+---
+name: 🚀 Feature Request
 description: Suggest an idea for this project
 title: "(short issue description)"
 labels: [feature-request, needs-triage]
+assignees: []
 body:
   - type: textarea
     id: description
@@ -10,41 +12,39 @@ body:
       description: A clear and concise description of the feature you are proposing.
     validations:
       required: true
-
   - type: textarea
-    id: problem
+    id: use-case
     attributes:
-      label: Is your Feature Request related to a problem?
+      label: Use Case
       description: |
-        A description of the issue, e.g. "I'm always frustrated when..."
+        Why do you need this feature? For example: "I'm always frustrated when..."
     validations:
-      required: true
-
+        required: true
   - type: textarea
     id: solution
     attributes:
       label: Proposed Solution
       description: |
-        Suggest how to implement the addition or change.
+        Suggest how to implement the addition or change. Please include prototype/workaround/sketch/reference implementation.
     validations:
       required: false
-
   - type: textarea
-    id: alternatives
+    id: other
     attributes:
-      label: Describe alternatives you've considered
+      label: Other Information
       description: |
-        Any alternative solutions or features you've considered.
+        Any alternative solutions or features you considered, a more detailed explanation, stack traces, related issues, links for context, etc.
     validations:
       required: false
-
   - type: checkboxes
-    id: acknowledgment
+    id: ack
     attributes:
-      label: Acknowledge
+      label: Acknowledgements
       options:
         - label: I may be able to implement this feature request
           required: false
+        - label: This feature might incur a breaking change
+          required: false
 
   - type: input
     id: go-sdk-version