diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml index 627385bde..acf399e4e 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yml +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -1,32 +1,30 @@ --- name: 📝 Bug Report description: Report a bug, error, or misbehavior -labels: ["1. bug", "2. status:unread"] +title: "Briefly summarize your issue here" +labels: ["1. bug", "needs-triage"] body: - type: markdown attributes: value: | **Thank you for reporting an issue to our issue tracker!** - > **Tip:** If you are seeking support or usage advice, head over to [our Discord](https://doomemacs.org/discord) or [our Discourse](https://discourse.doomemacs.org) instead. - Before you proceed, please consult our available resources and collect as much information about your issue as possible: + ----- - type: checkboxes attributes: options: - # - label: I have read the [contributing guide](https://discourse.doomemacs.org/how2contribute). - # required: true - label: I have searched [the FAQ](https://doomemacs.org/docs/faq.org) and [the documentation](https://doomemacs.org/docs/getting_started.org) for solutions. required: true - label: I have searched [the issue tracker](https://github.com/hlissner/doom-emacs/issues) for similar issues (the closed issues too). required: true - label: I can reproduce my issue on [the latest commit](https://github.com/hlissner/doom-emacs/commit) of Doom Emacs. required: true - # - label: I have searched [the Discourse](https://discourse.doomemacs.org/docs) for solutions. - # required: true - # - label: I have read [How to Debug Issues](https://discourse.doomemacs.org/how2debug) and found no solution. - # required: true + - label: I have searched [the Discourse](https://discourse.doomemacs.org/docs) for solutions. + required: true + - label: I have read [How to Debug Issues](https://discourse.doomemacs.org/how2debug) and found no solution. + required: true - type: textarea attributes: label: What did you expect to happen? @@ -37,9 +35,9 @@ body: attributes: label: What actually happened? description: | - Include screenshots/casts, logs, and [backtraces for errors](https://discourse.doomemacs.org/how2backtrace), if possible. - - **HINT: Remember to use [code fences](https://docs.github.com/en/github/writing-on-github/creating-and-highlighting-code-blocks) for code, log output, and backtraces.** + + Include screenshots/casts, if possible + + If you include log dumps, please use [pastebin.com](https://pastebin.com) + + If you're reporting an error, [include a backtrace](https://discourse.doomemacs.org/how2backtrace) in [code fences](https://docs.github.com/en/github/writing-on-github/creating-and-highlighting-code-blocks)** placeholder: | When I do X, Z happened. Here is the backtrace: @@ -51,6 +49,8 @@ body: apply(# (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 diff --git a/.github/ISSUE_TEMPLATE/bump_request.yml b/.github/ISSUE_TEMPLATE/bump_request.yml new file mode 100644 index 000000000..8f88b8a6d --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bump_request.yml @@ -0,0 +1,39 @@ +--- +name: 📝 Bump Package +description: Request a pinned package be updated +title: "[BUMP] package1, package2, ..." +labels: ["1. update", "needs-triage"] +body: +- type: markdown + attributes: + value: | + Doom pins its packages to certain commits to avoid breaking updates and to help its maintainer keep up with changes. These pins are updated (bumped) frequently, usually every other week, but some may warrant an early bump, due to critical bug fixes or to adapt to external events. + + Use this form to let us know about these packages. Alternatively, [file a bump PR](https://discourse.doomemacs.org/how2bump). + + ----- +- type: checkboxes + attributes: + options: + - label: There are no other bump requests for this package [on the issue tracker](https://github.com/hlissner/doom-emacs/pulls?q=is%3Apr+is%3Aopen+label%3A%221.+update%29%22+). + required: true + - label: The package(s) I want bumped are not in [the do-not-PR list](https://discourse.doomemacs.org/do-not-pr) list. + required: true + - label: These packages still need to be bumped on the [latest commit of Doom](https://github.com/hlissner/doom-emacs/commit). + required: true + - label: I've tested the new versions of these packages myself and can report on its issues (if any). + required: true +- type: textarea + attributes: + label: What package(s) should be bumped? + placeholder: | + lsp-mode, lsp-python-ms, lsp-pyright, ... + validations: + required: true +- type: textarea + attributes: + label: Why should Doom bump these packages early? + description: | + Briefly describe what has changed, and why they warrant an early bump. Link any relevant commits or issues, if possible. Mention anything Doom may have to change to accommodate it. + placeholder: | + Recent changes to X have fixed several open issues in Y and Z, but have broken A and B in Doom. diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml index 1183d7cce..d6c706e9c 100644 --- a/.github/ISSUE_TEMPLATE/config.yml +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -2,7 +2,7 @@ blank_issues_enabled: false contact_links: - name: Official Documentation url: https://doomemacs.org/docs/index.org - about: "Our in-repo manual documents. Also available from within Doom: `M-x doom/help`" + about: "Walks you through how to use, abuse, or confuse Doom Emacs. Also available from within Doom: `M-x doom/help`" - name: Visit our Discourse (work in progress) url: https://discourse.doomemacs.org about: "A repository of official learning resources and discussion forum for Emacs and Doom" diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md deleted file mode 100644 index f303d0b53..000000000 --- a/.github/ISSUE_TEMPLATE/feature_request.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -name: Feature request -about: It'd be cool if Doom did/had/would... ---- - -**Describe the feature** -- If the feature involves new plugins, include links to them -- 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 - - Links to its implementation - - Names of relevant commands (and not only the keybinds to invoke them) - - -**System information** - + +> - [ ] I've targeted the develop branch +> - [ ] I've searched for similar pull requests and found nothing +> - [ ] This change is NOT in Doom's do-not-PR list: https://doomemacs.org/d/do-not-pr +> - [ ] If I've bumped any packages, I've done so according to https://doomemacs.org/d/how2bump +> - [ ] I've linked any relevant issues and PRs below +> - [ ] All my commit messages are descriptive and distinct + +Fixes #0000 + +{{{ Summarize what you have changed. Include motivation and relevant context. }}} diff --git a/.github/PULL_REQUEST_TEMPLATE/bump.md b/.github/PULL_REQUEST_TEMPLATE/bump.md deleted file mode 100644 index 91330f0ea..000000000 --- a/.github/PULL_REQUEST_TEMPLATE/bump.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -name: Bump a package -about: Update a pinned package to a new commit -labels: is:update re:packages ---- -> You're about to request a package be bumped to a newer commit. -> -> 1. Please make sure this PR targets the `develop` branch and not `master`. -> 2. Describe why these bumps are necessary below -> 3. Please conform your commit messages to one of the following formats: -> -> Bump to username/repo@a1b2c3d -> -> From username/repo@z9y8x7w -> -> OR, if multiple packages are bumped in one commit: -> -> Bump :tools lsp -> -> emacs-lsp/lsp-mode@91e37a6 -> emacs-lsp/lsp-mode@c8188ef -> emacs-lsp/lsp-ui@cf6906c -> emacs-lsp/lsp-ui@582e153 -> -> Commit hashes should be limited to 7 characters. Include additional -> commentary after the list of commit changes. -> -> 4. You've included links to relevant issues, if any -> 5. You've deleted this template -> -> Thank you for contributing to Doom Emacs! <3 - -Explain why this bump is necessary here... diff --git a/.github/PULL_REQUEST_TEMPLATE/general.md b/.github/PULL_REQUEST_TEMPLATE/general.md deleted file mode 100644 index 05e9f9fc6..000000000 --- a/.github/PULL_REQUEST_TEMPLATE/general.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -name: General Contribution -about: A general code or documentation PR ---- -> Please follow these steps before submitting your PR: -> -> - [ ] Make sure yours is the only PR for your issue! -> - [ ] 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...