Update issue/PR templates

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,29 +1,33 @@
 ---
-name: "Bug report"
+name: Bug report
-about: "Something went wrong, please fix it!"
+about: Something went wrong, please fix it!
+labels: is:bug
 title: "[BUG] "
-labels: "is:bug", "status:pending-review"
+assignees: ''
 ---
 
-**Describe the bug**
+**Describe the issue**
-Begin with a short description of what the bug is.
+Start with a brief 1 or 2 sentence summary of issue.
 
-Some tips on writing a good bug report:
+Then follow with a longer explanation, if necessary. Here are some suggestions
-- Explain what you expected to see and what actually happened
+on what to include:
-- Include screenshots/casts of your issue, if possible
+- What you expected vs what actually happened
-- Add a link to your private config, if available
+- Screenshots/casts of your issue
-- Expand on phrases like "it does not work" and clarify what commands are bound
+- A link to your private config
-  on non-default keybinds.
+- Labels for any keys you reference (use `SPC h k` to inspect a key)
-- Check your \*Messages\* buffer for warnings or errors (`SPC h e` or `M-x
+- Any warnings or errors logged to \*Messages\* (`SPC h e` or `M-x
   view-echo-area-messages`).
-- Include a backtrace of the error, if possible. To acquire a backtrace, first
+
-  you must turn on `debug-on-error` then recreate the error. To do so, either:
+<details><pre>
-  - Turn on debug mode on the fly with `M-x toggle-debug-on-error`,
+If available, please a backtrace of the error here.
-  - Start Emacs with `emacs --debug-init`
+
-  - Or, if the error occurred while using `bin/doom`, use the `-d` or `--debug`
+To acquire a backtrace, enable `debug-on-error` then recreate the error. Here
-    switches, or the `DEBUG` environment variable.
+are ways to enable `debug-on-error`:
-- If the backtrace is especially long, put it in
+- `M-x toggle-debug-on-error`,
-  <details><pre>...</pre></details> tags.
+- Start Emacs with `emacs --debug-init`
+- If the error occurred while using `bin/doom`, use the `-d`/`--debug`
+- switches or the `DEBUG` environment variable.
+</pre></details>
 
 
 **Steps to reproduce**
@@ -35,5 +39,5 @@ Some tips on writing a good bug report:
 
 **System information**
 <details><pre>
-Include the output of `M-x doom/info` or `~/.emacs.d/bin/doom info` here.
+Place the output of `M-x doom/info` or `~/.emacs.d/bin/doom info` here.
 </pre></details>

.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,19 +1,25 @@
 ---
-name: "Feature Request"
+name: Feature request
-about: "Make suggestions for improving Doom Emacs"
+about: Make suggestions for improving Doom Emacs
-title: "[FEATURE] "
+labels: is:request
-labels: "is:request", "status:pending-review"
+title: "[REQUEST] "
+assignees: ''
 ---
 
 **Describe the feature**
-Summarize your suggestion or request.
+Start with a brief 1 or 2 sentence summary of feature.
 
-Include why it would be helpful and what type of user it would benefit most.
+Then follow up with an extended explanation, if necessary. Here are some
-
+suggestions on what to include:
-If this feature is implemented in another editor or Emacs distro, please include
+- How is it helpful?
-screenshots or screencasts of it. If possible, include the names of the relevant
+- How is the feature used?
-commands and not just the keybinds to invoke them. Links to their implementation
+- If the feature involves new plugins, include links to them
-in source code would tremendously speed up processing of this request.
+- 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:
+  - Include screenshots or screencasts of it
+  - Include links to its implementation
+  - Include names of commands (and not just the keybinds to invoke them)
 
 
 **System information**

.github/ISSUE_TEMPLATE/how_to.md

@@ -1,21 +1,21 @@
 ---
-name: "How do I..."
+name: How do I...
-about: "How to get Doom to behave a certain way"
+about: How to get Doom/Emacs to behave a certain way
+labels: is:howto, status:pending-review
 title: "[HOWTO] "
-labels: "is:howto", "status:pending-review"
+assignees: ''
 ---
 
 **What I want to achieve**
-Summarize what you are trying to do.
+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.
-- 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,
-- Screenshots/casts of similar features in another editor or elsewhere,
 - Additional material or links to resources that could help clarify what you are
   trying to do.
-- A link to your private config, if it is available publicly.
+- 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).
 

.github/ISSUE_TEMPLATE/question.md

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

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,12 @@
+> To ensure that this PR is processed as quickly as possible, please ensure the
+> following steps have been taken:
+> - [ ] This PR targets the develop branch and not master
+> - [ ] If your PR is a work in progress, include [WIP] in its title
+> - [ ] Its commits' summaries are reasonably descriptive
+> - [ ] You've described what this PR addresses below
+> - [ ] You've included links to relevant issues, if any
+> - [ ] You've deleted this template
+>
+> Thank you for contributing to Doom Emacs! <3
+
+Your description here...

.github/PULL_REQUEST_TEMPLATE/bug_fix.md

@@ -1,14 +0,0 @@
----
-name: "Bug Fix"
-about: "For fixing bugs originating from Doom"
-title: "[BUGFIX] "
-labels: "is:bug", "status:pending-review"
----
-
-> This category is for bug fixes.
-
-Thank you for contributing to Doom!
-
-Before you submit this PR, please make sure it is targeted at the `develop`
-branch and not `master`. Include links to relevant issues or, if the issue isn't
-self-evident, describe the problem that is being fixed.

.github/PULL_REQUEST_TEMPLATE/documentation.md

@@ -1,13 +0,0 @@
----
-name: "Documentation"
-about: "PRs that affect documentation files"
-title: "[DOCS] "
-labels: "re:docs", "status:pending-review"
----
-
-> This category is for additions or corrections to Doom's documentation.
-
-Thank you for contributing to Doom!
-
-Before you submit this PR, please make sure it is targeted at the `develop`
-branch and not `master`.

.github/PULL_REQUEST_TEMPLATE/feature.md

@@ -1,14 +0,0 @@
----
-name: "New Feature"
-about: "For new bells 'n whistles for old modules"
-title: "[FEATURE] "
-labels: "is:request", "status:pending-review"
----
-
-> This category is for PRs that add features to pre-existing modules or Doom
-> core.
-
-Thank you for contributing to Doom!
-
-Before you submit this PR, please make sure it is targeted at the `develop`
-branch and not `master`.

.github/PULL_REQUEST_TEMPLATE/maintenance.md

@@ -1,15 +0,0 @@
----
-name: "Maintenance"
-about: "Minor corrections, refactors or bugfixes for changes upstream"
-title: "[MAINTAIN] "
-labels: "is:refactor", "status:pending-review"
----
-
-> This category is for PRs that preform minor or cosmetic changes, refactors, or
-> fixes for bugs introduced by changes upstream or elsewhere.
-
-Thank you for contributing to Doom!
-
-Before you submit this PR, please make sure it is targeted at the `develop`
-branch and not `master`. Include links to relevant issues or, if the issue isn't
-self-evident, describe the problem that is being fixed.

.github/PULL_REQUEST_TEMPLATE/new_module.md

@@ -1,13 +0,0 @@
----
-name: "New Module"
-about: "For brand spankin' new modules"
-title: "[MODULE] "
-labels: "is:request", "re:module", "status:pending-review"
----
-
-> This category is for PRs that add new modules.
-
-Thank you for contributing to Doom!
-
-Before you submit this PR, please make sure it is targeted at the `develop`
-branch and not `master`.