Merge pull request #652 from cisagov/bl-issue-template-iterations

Improve bug issue template

.github/ISSUE_TEMPLATE/bug.yml

@@ -4,6 +4,12 @@ title: "[Bug]: "
 labels: ["bug"]
 
 body:
+  - type: markdown
+    id: help
+    attributes:
+      value: |
+        > **Note**
+        > GitHub Issues use [GitHub Flavored Markdown](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax) for formatting.
   - type: textarea
     id: current-behavior
     attributes:
@@ -24,25 +30,30 @@ body:
     id: steps-to-reproduce
     attributes:
       label: Steps to Reproduce
-      description: "How can the issue be reliably reproduced? feel free to include screenshots or other supporting artifacts"
-      placeholder: |
+      description: |
+        How can the issue be reliably reproduced? Feel free to include screenshots or other supporting artifacts
+        
         Example:
         1. In the test environment, fill out the application for a new domain
         2. Click the button to trigger a save/submit on the final page and complete the application 
         3. See the error
+      value: |
+        1.
     validations:
       required: true
   - type: textarea
     id: environment
     attributes:
-      label: Environment
-      description: "Where is this issue occurring? If related to development environment, list the specific relevant tool versions"
-      placeholder: |
+      label: Environment (optional)
+      description: |
+        Where is this issue occurring? If related to development environment, list the relevant tool versions.
+        
         Example:
+        - Environment: Sandbox
         - Browser: Chrome x.y.z
         - Python: x.y.z
   - type: textarea
     id: additional-context
     attributes:
-      label: Additional Context
+      label: Additional Context (optional)
       description: "Please include additional references, screenshots, documentation, etc. that are relevant"