Merge pull request #1525 from json-schema-org/gregsdennis/github-templates

update issue and pr templates

Author: gregsdennis

.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,33 @@
+name: 🧹 Clarification Needed
+description: Something in the specification is unclear
+title: "🧹 Clarification: "
+labels: ["🧹 Clarification", "Status: Triage"]
+body:
+- type: textarea
+  attributes:
+    label: Specification section
+    description:  Which specification document needs clarification?  Which section?
+    placeholder: |
+      [Core | Validation], Section: ? 
+  validations:
+    required: true
+- type: textarea
+  attributes:
+    label: What is unclear?
+    description: Please quote the current text and explain why it's unclear.
+  validations:
+    required: true
+- type: textarea
+  attributes:
+    label: Proposal
+    description: Do you have an idea to make the text more clear?
+  validations:
+    required: true
+- type: dropdown
+  attributes:
+    label: Do you think this work might require an [Architectural Decision Record (ADR)]? (significant or noteworthy)
+    options:
+      - 'Yes'
+      - 'No'
+  validations:
+    required: true

.github/ISSUE_TEMPLATE/clarification.yml

@@ -0,0 +1,29 @@
+name: ⭐️ Proposal
+description: Suggest an idea for a new feature
+title: "✨ Proposal: "
+labels: ["proposal", "Status: Triage"]
+body:
+- type: textarea
+  attributes:
+    label: Describe the inspiration for your proposal
+    description: Does the proposal address a problem you're facing?
+  validations:
+    required: true
+- type: textarea
+  attributes:
+    label: Describe the proposal
+    description: Please be as clear as possible and use examples.
+  validations:
+    required: true
+- type: textarea
+  attributes:
+    label: Describe alternatives you've considered
+    description: Can the functionality you're proposal be achieved with the features available today?
+  validations:
+    required: false
+- type: textarea
+  attributes:
+    label: Additional context
+    description: Is there anything else related to your proposal that you'd like to cover?
+  validations:
+    required: false

.github/ISSUE_TEMPLATE/proposal.yml

@@ -1,2 +1,28 @@
 <!-- Love json-schema? Please consider supporting our collective:
-👉  https://opencollective.com/json-schema/donate -->
+👉  https://opencollective.com/json-schema/donate -->
+
+<!-- In order to keep off topic discussion to a minimum, it helps if the "work to be done" is already agreed on. -->
+<!-- Ideally, a GitHub Issue with the label `Status: Consensus` will have been concluded, and linked to in this PR. -->
+
+<!--
+Thanks for submitting a pull request! Please provide enough information so that others can review your pull request.
+-->
+
+### What kind of change does this PR introduce?
+
+<!-- E.g. a bugfix, feature, refactoring, etc… -->
+
+### Issue & Discussion References
+
+<!-- Pick at least one of the below options, and remove those which don't apply. -->
+-  Closes #___ <!-- Replace ___ with the issue number this PR resolves -->
+-  Related to #___ <!-- Use when the PR doesn't completely resolve an issue -->
+-  Others? <!-- Add any additional notes or references here -->
+
+### Summary
+
+<!-- Explain the motivation for making this change. What existing problem does the pull request solve? -->
+
+### Does this PR introduce a breaking change?
+
+<!-- If this PR introduces a breaking change, please describe the impact and a migration path for existing applications. -->