chore: revise issue templates

.github/ISSUE_TEMPLATE/bug-report.yaml

@@ -11,47 +11,32 @@ body:
   - type: textarea
     attributes:
       label: Steps to reproduce
-      description: Provide detailed steps to replicate the bug.
+      description: Provide detailed steps to replicate the bug. Make sure to describe the current behavior. If applicable, include full errors, stack traces, and/or relevant logs.
       placeholder: |
         1. In this environment...
         2. With this config...
         3. Run '...'
         4. See error...
     validations:
       required: true
-  - type: textarea
-    attributes:
-      label: Expected behavior
-      description: What did you expect to happen?
-    validations:
-      required: true
-  - type: textarea
-    attributes:
-      label: Current behavior
-      description: |
-        What actually happened?
-
-        Include full errors, stack traces, and/or relevant logs.
-    validations:
-      required: true
   - type: textarea
     attributes:
       label: Acceptance Criteria
       description: |
         Provide the criteria that must be met in order for this issue to be considered fixed.
-        Be specific, and consider potential edge cases.
+        Be specific, and consider potential edge cases. The criteria should be observable and testable.
+      placeholder: |
+        Given a user or system is in ... (a page, workflow, or state)
+        And ... (optional other criteria that needs to be met)
+        When the user ... (action)
+        Then ... (expected outcome)
+        And ... (additional observable outcome)
     validations:
       required: true
   - type: textarea
     attributes:
-      label: Possible reason(s)
-      description: Provide any insights into what might be causing the issue.
-    validations:
-      required: false
-  - type: textarea
-    attributes:
-      label: Suggested fix
-      description: Provide any suggestions on how to resolve the bug.
+      label: Possible reason(s)/Suggested Fix
+      description: Provide any insights into what might be causing the issue or how to resolve it.
     validations:
       required: false
   - type: textarea
@@ -63,31 +48,9 @@ body:
         commit: abc123d
     validations:
       required: true
-  - type: textarea
-    attributes:
-      label: Screenshots
-      description: If applicable, add screenshots with descriptions to help explain your problem.
-    validations:
-      required: false
   - type: textarea
     attributes:
       label: Environment details
       description: Provide environment details (OS name and version, etc).
     validations:
       required: true
-  - type: textarea
-    attributes:
-      label: Additional details
-      description: Provide any other additional details about the problem.
-    validations:
-      required: false
-  - type: dropdown
-    attributes:
-      label: Contribution
-      description: Can you contribute to the development of this feature?
-      options:
-        - "Yes, I can create a PR for this fix."
-        - "Yes, but I can only provide ideas and feedback."
-        - "No, I cannot contribute."
-    validations:
-      required: false

.github/ISSUE_TEMPLATE/feature-request.yaml

@@ -20,25 +20,19 @@ body:
       label: Acceptance Criteria
       description: |
         Provide the criteria that must be met in order for this issue to be considered complete.
-        Be specific, and consider potential edge cases.
+        Be specific, and consider potential edge cases. The criteria should be observable and testable.
+      placeholder: |
+        Given a user or system is in ... (a page, workflow, or state)
+        And ... (optional other criteria that needs to be met)
+        When the user ... (action)
+        Then ... (expected outcome)
+        And ... (additional observable outcome)
     validations:
       required: true
   - type: textarea
     attributes:
       label: Proposed solution
-      description: Provide proposed solution.
-    validations:
-      required: false
-  - type: textarea
-    attributes:
-      label: Alternatives considered
-      description: Describe any alternative solutions you've considered.
-    validations:
-      required: false
-  - type: textarea
-    attributes:
-      label: Implementation details
-      description: Provide any technical details on how the feature might be implemented.
+      description: Provide proposed solution and any technical details on how the feature might be implemented.
     validations:
       required: false
   - type: textarea
@@ -50,19 +44,3 @@ body:
         What challenges might arise?
     validations:
       required: false
-  - type: textarea
-    attributes:
-      label: Additional context
-      description: Provide any other context or screenshots about the feature.
-    validations:
-      required: false
-  - type: dropdown
-    attributes:
-      label: Contribution
-      description: Can you contribute to the development of this feature?
-      options:
-        - "Yes, I can create a PR for this feature."
-        - "Yes, but I can only provide ideas and feedback."
-        - "No, I cannot contribute."
-    validations:
-      required: false