doomemacs/.github/ISSUE_TEMPLATE/bug_report.yml
Henrik Lissner 4a4315e36a
dev: remove feature/bump request issue forms
This removes the feature and bump request templates, as our issue
tracker will no longer accept them. They should either be submitted to
our Discourse/Discord, or come in the form of a pull request (as a proof
of concept proposal/RFC), or a bug report (in case a bump is needed to
address a bug).

Ref: https://discourse.doomemacs.org
Ref: https://doomemacs.org/discord
2022-09-18 21:12:25 +02:00

97 lines
4.8 KiB
YAML

---
name: 📝 Bug Report
description: Report something that isn't working as intended
labels: ["is:bug", "needs-triage"]
body:
- type: markdown
attributes:
value: |
> :warning: Our issue tracker is only for bug reports, not feature requests, or general user support. Submit those to [our Discourse](https://discourse.doomemacs.org) or [our Discord server](https://doomemacs.org/discord) instead.
**Before you proceed, please ensure your issue:**
- Wasn't already reported on [our issue tracker](https://github.com/hlissner/doom-emacs/issues) or [Discourse](https://discourse.doomemacs.org),
- Hasn't been covered by [our FAQ](https://github.com/hlissner/doom-emacs/blob/master/docs/faq.org),
- Can be reproduced on the **latest commit** of Doom,
- Is reproducible on Emacs 27 or 28, _(Emacs 29 is not supported!)_
- Is reproducible in [vanilla Doom](https://github.com/hlissner/doom-emacs/blob/master/docs/getting_started.org#testing-in-dooms-sandbox) (i.e. with your private config disabled),
- Is well-researched using [our troubleshooting guide](https://github.com/hlissner/doom-emacs/blob/master/docs/getting_started.org#troubleshoot).
- Has not been reported upstream (e.g. in the repos of any involved packages).
- type: textarea
attributes:
label: What did you expect to happen?
placeholder: When I do X, it should do Y.
validations:
required: true
- type: textarea
attributes:
label: What actually happened?
description: |
- Screenshots and gifs are a big help!
- Check the \*Messages\* buffer for errors and/or warnings (press `C-h e` to view this buffer).
- **Always include backtraces for errors.** ([How to produce a backtrace](https://doomemacs.org/d/how2backtrace))
- **Use [code fences](https://docs.github.com/en/github/writing-on-github/creating-and-highlighting-code-blocks) for code, logs, or text dumps!** Or use pastebin.com!
- Be specific! Phrases like "X does not work" or "X stopped working" are unacceptable.
placeholder: |
When I do X, Z happened. Here is the backtrace:
```
Debugger entered--Lisp error: (error "Beep Boop")
error("Beep Boop")
pp-eval-expression((error "Beep Boop"))
\#<subr funcall-interactively>(pp-eval-expression (error "Beep Boop"))
apply(#<subr funcall-interactively> (pp-eval-expression (error "Beep Boop")))
funcall-interactively(pp-eval-expression (error "Beep Boop"))
```
And here is the log: https://pastebin.com/fakeurl
validations:
required: true
- type: textarea
attributes:
label: Describe your attempts to resolve the issue
description: |
How have you tried to fix your issue? What was the result?
_(Hint: use [code fences](https://docs.github.com/en/github/writing-on-github/creating-and-highlighting-code-blocks) for code or text dumps!)_
placeholder: |
I tried setting X to Y, then I tried Z. Here's what else I tried...
```elisp
(setq variable value)
```
- type: textarea
attributes:
label: Steps to reproduce
description: |
How do we reproduce your issue? Walk us through a minimal test case.
> :warning: This is required! If you can't offer steps to reproduce it, the issue will be immediately closed!
placeholder: |
1. Open Emacs
2. `M-x doom/info` and be prompted to visit pastebin.com
3. Press `y` to open pastebin.com in browser
4. Paste the contents of my clipboard into text box
5. Click "Create New Paste"
6. My wife leaves me
validations:
required: true
- type: input
id: doominfo
attributes:
label: System Information
description: |
Provide a [pastebin.com](https://pastebin.com) link to the output of `M-x doom/info` or `$ ~/.emacs.d/bin/doom info`.
> :warning: **This _must_ be a pastebin.com link.** Please don't use any other service, please don't paste your doom-info directly into this box, and please don't omit it. If you can't provide it, **please explain why in the box below or other fields above!**
placeholder: https://pastebin.com/fakeurl
validations:
required: true
- type: markdown
attributes:
value: |
Please take a moment to ensure your issue (and it's title) is **well-researched, descriptive, and specific**, otherwise, you risk it being significantly delayed or automatically closed.
Emacs' complexity produces many false positive and vague bug reports, so issues that aren't **actionable**, **reproducible in vanilla Doom**, or able to be investigated in a **reasonable amount of time** will be closed. If you think your issue might fall into these categories, please bring it up on [our Discord](https://doomemacs.org/discord) or [Discourse](https://discourse.doomemacs.org) instead.
:heart: **Thank you for taking the time to file this bug report!**