From 698c297ef9ba96cdd4d4f0eebbb1217053b6e6a3 Mon Sep 17 00:00:00 2001
From: Chris Montgomery <chris@cdom.io>
Date: Sun, 31 Jul 2022 10:52:21 -0400
Subject: [PATCH] meta: rework/cleanup/clarify bug issue template

---
 .github/ISSUE_TEMPLATE/bug_report.md | 82 ++++++++++++++--------------
 1 file changed, 42 insertions(+), 40 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
index 7845ae4..be3b90f 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.md
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -1,51 +1,53 @@
 ---
 name: Bug report
-about: Create a report to help improve
+about: Create a report to help us improve
 title: ''
 labels: 'bug'
 assignees: ''
-
 ---
 
-Your issue may already be reported!
-Please search on the [issue tracker](../) before creating one.
-
 ## Expected Behavior
-<!--- What should happen? -->
-<!--- How it should work? -->
 
-## Current Behavior
-<!--- What happens instead of the expected behavior? -->
-
-## Possible Solution
-<!--- Not obligatory, but suggest a fix/reason for the bug, -->
-<!--- or ideas how to implement the addition or change -->
-
-## Steps to Reproduce
-<!--- An unambiguous set of steps to reproduce this bug. -->
-<!--- Linked fork or gist if needed. -->
-1.
-2.
-3.
-4.
-
-## Context
-<!--- How has this issue affected you? What are you trying to accomplish? -->
-<!--- Providing context helps us come up with a solution that is most useful in the real world. -->
-
-## Your Environment
-<!---Please run `nix-shell -p nix-info --run "nix-info -m"` and paste the result. -->
-
-```console
-[user@system:~]$ nix-shell -p nix-info --run "nix-info -m"
-output here
-```
-
-<!---
-Include any additional relevant details about the environment in which you
-encountered the bug.
-
-For example, if you encountered this issue after running `nix flake update`,
-include the contents of the new flake.lock file.
+<!--
+A clear and concise description of what you expected to happen.
 -->
 
+## Current Behavior
+
+<!--
+What happens instead of the expected behavior?
+-->
+
+## Steps to Reproduce
+
+<!--
+An unambiguous set of steps to reproduce the behavior.
+Without this, others may find it difficult to see what you are seeing.
+Provide a link to repo or gist if you think it could be helpful.
+-->
+
+1. ...
+2. ...
+3. ...
+
+## Additional Context
+
+<!--
+For example:
+- How has this issue affected you?
+- What are you trying to accomplish?
+- Do you have an idea about what may have caused the issue?
+- Provide a link to your related code in a repo or gist.
+- If applicable, add screenshots to help explain your problem.
+-->
+
+## Your Environment
+
+<!--
+Please run `nix run nixpkgs#nix-info -- -m; nix flake metadata` and paste the result:
+-->
+
+```console
+[user@system:~]$ nix run nixpkgs#nix-info -- -m; nix flake metadata
+output here
+```