From 6c98003ffb077417999db58e3e0ca8bbd941a587 Mon Sep 17 00:00:00 2001 From: Lena <241371603+zelenenka@users.noreply.github.com> Date: Fri, 28 Nov 2025 16:46:42 +0100 Subject: [PATCH] Tweak the issue template for bugs (#43719) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - shorten some phrases to (hopefully) retain attention better - move the required field up to not bore people with scrolling - call it a bug and not an issue to further emphasize we want feature requests in Discussions where the product managers are - remove the default from the WSL question since not everyone does WSL or even Windows Release Notes: - N/A --------- Co-authored-by: Miguel Raz Guzmán Macedo Co-authored-by: Kunall Banerjee --- .github/ISSUE_TEMPLATE/1.bug-report.yml | 50 ++++++++++++------------- 1 file changed, 24 insertions(+), 26 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/1.bug-report.yml b/.github/ISSUE_TEMPLATE/1.bug-report.yml index 3fcf81113093be06f9477a0c89af979444fd016d..845c0a480b7552bebb3c2f1bb869f13f058f7495 100644 --- a/.github/ISSUE_TEMPLATE/1.bug-report.yml +++ b/.github/ISSUE_TEMPLATE/1.bug-report.yml @@ -1,39 +1,50 @@ -name: Report an issue -description: Report an issue with Zed. +name: Report a bug +description: Report a problem with Zed. type: Bug labels: "state:needs triage" body: - type: markdown attributes: value: | - Feature requests should be opened in [discussions](https://github.com/zed-industries/zed/discussions/new/choose). + Is this bug already reported? Upvote to get it noticed faster. [Here's the search](https://github.com/zed-industries/zed/issues). Upvote means giving it a :+1: reaction. - Before opening a new issue, please do a [search](https://github.com/zed-industries/zed/issues) of existing issues and :+1: upvote the existing issue instead. This will help us maintain a proper signal-to-noise ratio. + Feature request? Please open in [discussions](https://github.com/zed-industries/zed/discussions/new/choose) instead. - If you need help with your own project, you can ask a question in our [Discord Support Forums](https://discord.com/invite/zedindustries). + Just have a question or need support? Welcome to [Discord Support Forums](https://discord.com/invite/zedindustries). - type: textarea attributes: label: Reproduction steps - description: A step-by-step description of how to reproduce the issue from a **clean Zed install**. Any code must be sufficient to reproduce (make sure to include context!). Include code as text, not just as a screenshot. **Issues with insufficient detail may be summarily closed**. + description: A step-by-step description of how to reproduce the bug from a **clean Zed install**. The more context you provide, the easier it is to find and fix the problem fast. placeholder: | 1. Start Zed 2. Click X - 3. Y will happen validations: required: true - type: textarea attributes: label: Current vs. Expected behavior description: | - A clear and concise description of what is the current behavior (screenshots, videos), vs. what you expected the behavior to be. + Current behavior (screenshots, videos, etc. are appreciated), vs. what you expected the behavior to be. - **Skipping this/failure to provide complete information will result in the issue being closed.** - placeholder: "Based on my reproduction steps above, when I click X, I expect this to happen, but instead Y happens." + placeholder: | + Current behavior: The icon is blue. Expected behavior: The icon should be red because this is what the setting is documented to do. + validations: + required: true + - type: textarea + attributes: + label: Zed version and system specs + description: | + Open the command palette in Zed, then type “zed: copy system specs into clipboard”. + placeholder: | + Zed: v0.215.0 (Zed Nightly bfe141ea79aa4984028934067ba75c48d99136ae) + OS: macOS 15.1 + Memory: 36 GiB + Architecture: aarch64 validations: required: true - type: textarea attributes: - label: If applicable, attach your Zed log file to this issue. + label: Attach Zed log file description: | Open the command palette in Zed, then type `zed: open log` to see the last 1000 lines. Or type `zed: reveal log in file manager` in the command palette to reveal the log file itself. value: | @@ -49,7 +60,7 @@ body: required: false - type: textarea attributes: - label: If applicable, attach your relevant Zed settings to this issue + label: Relevant Zed settings description: | Open the command palette in Zed, then type “zed: open settings file” and copy/paste any relevant (e.g., LSP-specific) settings. value: | @@ -65,7 +76,7 @@ body: required: false - type: textarea attributes: - label: If applicable, provide details about your model provider + label: (for AI issues) Model provider details placeholder: | - Provider: (Anthropic via ZedPro, Anthropic via API key, Copilot Chat, Mistral, OpenAI, etc.) - Model Name: (Claude Sonnet 4.5, Gemini 3 Pro, GPT-5) @@ -73,18 +84,6 @@ body: - Other details (ACPs, MCPs, other settings, etc.): validations: required: false - - type: textarea - attributes: - label: Zed version and system specs - description: | - Open the command palette in Zed, then type “zed: copy system specs into clipboard”. **Skipping this/failure to provide complete information will result in the issue being closed**. - placeholder: | - Zed: v0.215.0 (Zed Nightly bfe141ea79aa4984028934067ba75c48d99136ae) - OS: macOS 15.1 - Memory: 36 GiB - Architecture: aarch64 - validations: - required: true - type: dropdown attributes: label: If you are using WSL on Windows, what flavor of Linux are you using? @@ -97,4 +96,3 @@ body: - Pop!_OS - NixOS - Other - default: 0