chore(meta): update issue templates

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,38 +1,40 @@
 ---
 name: Bug report
 about: Create a report to help us improve
-title: ''
+title: ""
 labels: bug
 assignees: rektdeckard
-
 ---
 
-**Describe the bug**
+<!-- BEFORE YOU REPORT -->
-A clear and concise description of what the bug is.
+<!-- 1. Search for existing issues! If the issue has already been reported, add a 👍 or a comment to help show your interest. -->
+<!-- 2. If your issue pertains to a specific library, please leave it on the relevant repository! -->
 
-**To Reproduce**
+**Describe the bug**
-Steps to reproduce the behavior:
+
-1. Go to '...'
+<!-- A clear and concise description of what the bug is. -->
-2. Click on '....'
+
-3. Scroll down to '....'
+**Steps to Reproduce**
-4. See error
+
+<!-- Steps to reproduce the behavior. -->
 
 **Expected behavior**
-A clear and concise description of what you expected to happen.
+
+<!-- A clear and concise description of what you expected to happen. -->
 
 **Screenshots**
-If applicable, add screenshots to help explain your problem.
 
-**Desktop (please complete the following information):**
+<!-- If applicable, add screenshots to help explain your problem. -->
- - OS: [e.g. iOS]
- - Browser [e.g. chrome, safari]
- - Version [e.g. 22]
 
-**Smartphone (please complete the following information):**
+**Context (please complete the following information):**
- - Device: [e.g. iPhone6]
- - OS: [e.g. iOS8.1]
- - Browser [e.g. stock browser, safari]
- - Version [e.g. 22]
 
-**Additional context**
+<!--
-Add any other context about the problem here.
+- OS: [e.g. Windows 10]
+- Browser/Environment [e.g. chrome, safari, node]
+- Library [e.g. @phosphor-icons/react]
+- Version [e.g. 2.1.0]
+-->
+
+**Additional notes**
+
+<!-- Add any other context about the problem here. -->

.github/ISSUE_TEMPLATE/icon_request.md

@@ -1,17 +1,24 @@
 ---
 name: Icon request
-about: Request an icon you'd like to see added
+about: Request one or more related icons you'd like to see added to our set
-title: ''
+title: ""
 labels: enhancement
 assignees: rektdeckard
-
 ---
 
-**Describe the requested icon**
+<!-- BEFORE YOU REQUEST -->
-Explain the icon you'd like to see, and potential use-cases.
+<!-- 1. Search for existing issues! If the icon has already been requested, add a 👍 or a comment to help show your interest. -->
+<!-- 2. If requesting a brand icon, check this discussion to see if it meets the criteria: https://github.com/orgs/phosphor-icons/discussions/392 -->
+<!-- 3. If requesting a visual change to an existing icon, make sure it is based on clarity, consistency, or readability -->
 
-**Screenshots**
+**Describe the requested icon(s)**
-If applicable, add screenshots to help illustrate the icon appearance.
+
+<!-- Explain the icon(s) you'd like to see, and potential use-cases. Be specific. Do not say "etc..." unless it is unambiguous what that means. -->
+
+**References**
+
+<!-- If applicable, add screenshots, examples, or references to the icon(s) in other sets. -->
 
 **Additional context**
-Add any other context here.
+
+<!-- Add any other context here. -->