summaryrefslogtreecommitdiff
path: root/.github/ISSUE_TEMPLATE/bug_report.md
diff options
context:
space:
mode:
authorMassimiliano Culpo <massimiliano.culpo@gmail.com>2018-08-20 21:24:42 +0200
committerscheibelp <scheibel1@llnl.gov>2018-08-20 15:24:42 -0400
commit2cd3e3fa76c20b0cde6c7fb60ad1a430e5a6d9f3 (patch)
tree95fe600b9ffab3060715e52e004844f5d11c22b3 /.github/ISSUE_TEMPLATE/bug_report.md
parent271633ee939b43640a99423ac49e7d1c44244520 (diff)
downloadspack-2cd3e3fa76c20b0cde6c7fb60ad1a430e5a6d9f3.tar.gz
spack-2cd3e3fa76c20b0cde6c7fb60ad1a430e5a6d9f3.tar.bz2
spack-2cd3e3fa76c20b0cde6c7fb60ad1a430e5a6d9f3.tar.xz
spack-2cd3e3fa76c20b0cde6c7fb60ad1a430e5a6d9f3.zip
Introduce templates for specific issue types (#8842)
This replaces the single github issue-reporting template with templates for the following types of issues: * Build issues * Spack command errors * Feature request Each template includes suggestions which are generally useful for the type of issue encountered.
Diffstat (limited to '.github/ISSUE_TEMPLATE/bug_report.md')
-rw-r--r--.github/ISSUE_TEMPLATE/bug_report.md49
1 files changed, 49 insertions, 0 deletions
diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
new file mode 100644
index 0000000000..d9512c06c3
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -0,0 +1,49 @@
+---
+name: Bug report
+about: Report a bug in the core of Spack (command not working as expected, etc.)
+
+---
+
+
+*Explain, in a clear and concise way, the command you ran and the result you were trying to achieve.
+Example: "I ran Spack find to list all the installed packages and..."*
+
+
+
+### Steps to reproduce the issue
+
+```console
+$ spack <command1> <spec>
+$ spack <command2> <spec>
+...
+```
+
+### Error Message
+
+If Spack reported an error, provide the error message. If it did not report an error
+but the output appears incorrect, provide the incorrect output. If there was no error
+message and no output but the result is incorrect, describe how it does not match
+what you expect. To provide more information you might re-run the commands with
+the additional -sd flags:
+```console
+$ spack -sd <command1> <spec>
+$ spack -sd <command2> <spec>
+...
+```
+that activate the full debug output.
+
+
+### Information on your system
+
+This includes:
+
+ 1. which platform you are using
+ 2. any relevant configuration detail (custom `packages.yaml` or `modules.yaml`, etc.)
+
+-----
+
+We encourage you to try, as much as possible, to reduce your problem to the minimal example that still reproduces the issue. That would help us a lot in fixing it quickly and effectively!
+
+If you want to ask a question about the tool (how to use it, what it can currently do, etc.), try the `#general` channel on our Slack first. We have a welcoming community and chances are you'll get your reply faster and without opening an issue.
+
+Other than that, thanks for taking the time to contribute to Spack! \ No newline at end of file