Add issue templates to docc-render (swiftlang#384)

* [r96950970] feat: add issue templates

* Update .github/ISSUE_TEMPLATE/BUG_REPORT.yml

Co-authored-by: Franklin Schrans <[email protected]>

* [r96950970] chore: address feedback

Co-authored-by: Franklin Schrans <[email protected]>

Author: marinaaisa

.github/ISSUE_TEMPLATE/BUG_REPORT.yml

@@ -0,0 +1,59 @@
+name: Bug Report
+description: Something isn't working as expected
+labels: [bug]
+body:
+- type: markdown
+  attributes:
+    value: |
+      Thank you for contributing to Swift-DocC-Render! 
+      
+      Before you submit your issue, please complete each text area below with the relevant details for your bug, and complete the steps in the checklist.
+- type: textarea
+  attributes:
+    label: Description
+    description: |
+      A short description of the incorrect behavior. 
+
+      If you think this issue has been recently introduced and did not occur in an earlier version, please note that. If possible, include the last version that the behavior was correct in addition to your current version.
+  validations:
+    required: true
+- type: checkboxes
+  attributes:
+    label: Checklist
+    options:
+    - label: If possible, I've reproduced the issue using the `main` branch of this package.
+      required: false
+    - label: This issue hasn't been addressed in an [existing GitHub issue](https://github.com/apple/swift-docc-render/issues).
+      required: true
+- type: textarea
+  attributes:
+    label: Expected Behavior
+    description: Describe what you expected to happen.
+  validations:
+    required: false
+- type: textarea
+  attributes:
+    label: Actual behavior
+    description: Describe or copy/paste the behavior you observe.
+  validations:
+    required: false
+- type: textarea
+  attributes:
+    label: Steps To Reproduce
+    description: |
+      Explanation of how to reproduce the incorrect behavior. 
+      
+      This could include a reduced version of your documentation bundle, or a link to the documentation (or code) that is exhibiting the issue.
+    placeholder: |
+      1. In this browser version...
+
+      2. With this viewport size...
+      
+      3. See error/bug...
+  validations:
+    required: false
+- type: input
+  attributes:
+    label: Swift-DocC-Render Version Information
+    description: The version of Swift-DocC-Render used to reproduce this issue.
+    placeholder: "'0.1.0' for example, or a commit hash"

.github/ISSUE_TEMPLATE/FEATURE_REQUEST.yml

@@ -0,0 +1,49 @@
+name: Feature Request
+description: A suggestion for a new feature
+labels: [New Feature]
+body:
+- type: markdown
+  attributes:
+    value: |
+      Thank you for contributing to Swift-DocC-Render!
+      
+      Before you submit your issue, please replace each text area below with information about your proposed feature.
+- type: input
+  attributes:
+    label: Feature Name
+  validations:
+    required: true
+- type: textarea
+  attributes:
+    label: Description
+    description: |
+      A description of your proposed feature.
+
+      Design proposals to show what's missing, or what new capabilities will be possible, are very helpful! Provide links to existing issues or external references/discussions, if appropriate.
+
+      How does it behave in different viewports?
+
+      Are there accessibility considerations for this feature?
+  validations:
+    required: true
+- type: textarea
+  attributes:
+    label: Motivation
+    description: A description of the use-case this proposal is trying to serve.
+  validations:
+    required: false
+- type: textarea
+  attributes:
+    label: Importance
+    description: |
+      A description of the importance of this change.
+
+      Does this feature unlock entirely new use-cases? Or is it possible to achieve the same functionality with existing functionality and this change would improve the user experience?
+  validations:
+    required: false
+- type: textarea
+  attributes:
+    label: Alternatives Considered
+    description: If you considered alternative approaches for this feature, please include them here.
+  validations:
+    required: false

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,24 @@
+# This source file is part of the Swift.org open source project
+#
+# Copyright (c) 2022 Apple Inc. and the Swift project authors
+# Licensed under Apache License v2.0 with Runtime Library Exception
+#
+# See https://swift.org/LICENSE.txt for license information
+# See https://swift.org/CONTRIBUTORS.txt for Swift project authors
+
+# This is set to `false` to encourage users to use the provided templates instead
+# of beginning with a blank one.
+#
+# For details, see: https://docs.github.com/communities/using-templates-to-encourage-useful-issues-and-pull-requests/configuring-issue-templates-for-your-repository#configuring-the-template-chooser
+blank_issues_enabled: false
+
+contact_links:
+  - name: Discussion Forum
+    url: https://forums.swift.org/c/development/swift-docc
+    about: Ask and answer questions about Swift-DocC
+  - name: Swift-DocC Documentation
+    url: https://www.swift.org/documentation/docc/
+    about: Learn about how to use the Swift-DocC documentation tool in your projects
+  - name: Swift-DocC Technical Documentation
+    url: https://apple.github.io/swift-docc/documentation/swiftdocc/
+    about: Read Swift-DocC's technical API documentation