Simplify github issue templates; correct labels

If they're too long, people won't read them.
If they're too short, people won't know what to do.
If there are too many of them, people can't decide which to use.

Removed the question template because it's redundant with "open a blank
issue".
This commit is contained in:
Henrik Lissner 2019-11-28 15:32:50 -05:00
parent 9bd8904838
commit ae80f1f67d
No known key found for this signature in database
GPG key ID: 5F6C0EA160557395
4 changed files with 29 additions and 48 deletions

View file

@ -1,32 +1,26 @@
---
name: Bug report
about: Something went wrong, please fix it!
about: Doom might be misbehaving
labels: is:bug
title: "[BUG] "
assignees: ''
---
**Describe the issue**
Start with a brief 1 or 2 sentence summary of issue.
Then follow with a longer explanation, if necessary. Here are some suggestions
on what to include:
- What you expected vs what actually happened
- Screenshots/casts of your issue
- A link to your private config
- Labels for any keys you reference (use `SPC h k` to inspect a key)
- Any warnings or errors logged to \*Messages\* (`SPC h e` or `M-x
view-echo-area-messages`).
- What did you expect to happen?
- What actually happened?
- Do you have screenshots/casts of your issue?
- What commands are bound to any keys you've referenced? (use `SPC h k` to
inspect keys)
- Can you include a link to your private config?
- Were any warnings or errors logged to \*Messages\* (`SPC h e` or `M-x
view-echo-area-messages` will open it).
<details><pre>
If available, please a backtrace of the error here.
Include a backtrace of the error.
To acquire a backtrace, enable `debug-on-error` then recreate the error. Here
are ways to enable `debug-on-error`:
- `M-x toggle-debug-on-error`,
- Start Emacs with `emacs --debug-init`
- If the error occurred while using `bin/doom`, use the `-d`/`--debug`
- switches or the `DEBUG` environment variable.
How to acquire a backtrace:
https://github.com/hlissner/doom-emacs/blob/develop/docs/getting_started.org#how-to-extract-a-backtrace-from-an-error
</pre></details>

View file

@ -1,22 +1,19 @@
---
name: Feature request
about: Make suggestions for improving Doom Emacs
about: It'd be cool if Doom did/had/would...
labels: is:request
title: "[REQUEST] "
assignees: ''
---
**Describe the feature**
Start with a brief 1 or 2 sentence summary of feature.
Then follow up with an extended explanation, if necessary. Here are some
suggestions on what to include:
- What is your request?
- How is it helpful?
- How is the feature used?
- How is it used?
- If the feature involves new plugins, include links to them
- iF the feature involves replacement of current functionality, describe how the
new functionality is better.
- If the feature is implemented in another editor Emacs distro:
- If the feature involves replacement of current functionality, how the new
functionality is better?
- If the feature is implemented in another editor or Emacs distro:
- Include screenshots or screencasts of it
- Include links to its implementation
- Include names of commands (and not just the keybinds to invoke them)
@ -25,4 +22,7 @@ suggestions on what to include:
**System information**
<details><pre>
Include the output of `M-x doom/info` or `~/.emacs.d/bin/doom info` here.
It's possible Doom already has the feature you're requesting. This will tell me
why you aren't seeing it.
</pre></details>

View file

@ -1,23 +1,19 @@
---
name: How do I...
about: How to get Doom/Emacs to behave a certain way
labels: is:howto, status:pending-review
labels: is:question
title: "[HOWTO] "
assignees: ''
---
**What I want to achieve**
Start with a brief 1 or 2 sentence summary of what you're trying to achieve.
Follow up with an expanded explanation, if necessary. A few suggestions of what
you could include are:
- Code or steps you've tried that did not yield the results you wanted.
- Screenshots/casts of a proposed workflow in another editor or Emacs distro,
- Additional material or links to resources that could help clarify what you are
trying to do.
- A link to your private config, if available.
- The names of commands available in other Emacs distros (rather than just the
keybinds that invoke them).
- What are you trying to achieve?
- What have you tried?
- Do you have screenshots/casts of this workflow in another editor or Emacs
distro? (If possible, include names of specific commands or functions from
other editors/kemacs distros)
- Do you have extra material or links to resources that could help clarify what
you are trying to do?
**System information**

View file

@ -1,9 +0,0 @@
---
name: Question
about: A question about the project or maintainer
labels: is:question, status:pending-review
title: "[QUESTION] "
assignees: ''
---
What would you like to know?