diff --git a/.github/ISSUE_TEMPLATE/bug.yml b/.github/ISSUE_TEMPLATE/bug.yml index cfbb94adb..1e6139cfb 100644 --- a/.github/ISSUE_TEMPLATE/bug.yml +++ b/.github/ISSUE_TEMPLATE/bug.yml @@ -16,17 +16,17 @@ body: - Check if someone else has **already reported this** or if it's been fixed on the main branch - You **must** include a copy/pasteable, properly formatted MRE (minimal reproducible example) or your issue may be closed without response - **The ideal issue is a clear problem description and an MRE — that's it.** If you've done genuine investigation and have a non-obvious insight into the root cause, include it. But please don't speculate or ask an LLM to generate a diagnosis. We have LLMs too, and an incorrect analysis is harder to work with than none at all. - - **Keep it short.** Issues that are difficult to parse — due to length, speculation, or generated content — may be closed without response. + - **Keep it short.** A clear description plus a concise MRE is ideal — aim to fit in a single screen. Issues that include unsolicited root cause analysis, proposed fixes, or multi-section diagnostic writeups will be labeled `too-long` and not triaged until condensed. - **Using an LLM?** Great — but it must follow these guidelines. Generic LLM output that ignores our contributing conventions will be closed. See [CONTRIBUTING.md](../../CONTRIBUTING.md). - type: textarea id: description attributes: - label: Description + label: What happened? description: | - Please explain what you're experiencing and what you would expect to happen instead. + Describe the bug in a few sentences. What did you do, what happened, and what did you expect instead? - Provide as much detail as possible to help us understand and solve your problem quickly. + Do NOT include root cause analysis, proposed fixes, or diagnostic writeups — just describe the problem. validations: required: true diff --git a/.github/ISSUE_TEMPLATE/enhancement.yml b/.github/ISSUE_TEMPLATE/enhancement.yml index ca0680bd2..39c66647d 100644 --- a/.github/ISSUE_TEMPLATE/enhancement.yml +++ b/.github/ISSUE_TEMPLATE/enhancement.yml @@ -14,7 +14,7 @@ body: - 🔍 **Check if this has already been requested** — search existing issues first - 🎯 **Describe the problem you're trying to solve**, not the solution you want — we'll figure out the best implementation - - ✂️ **Keep it short.** A motivating description and a concrete use case is the ideal request. Skip proposed implementations unless you have a specific, well-considered suggestion. Requests that are difficult to parse may be closed without response. + - ✂️ **Keep it short.** A motivating description and a concrete use case is the ideal request — aim to fit in a single screen. Skip proposed implementations, API designs, or multi-option analyses — maintainers will figure out the approach. Requests that are difficult to parse will be labeled `too-long` and not triaged until condensed. - 🤖 **Using an LLM?** Great — but it must follow these guidelines. Generic LLM output that ignores our contributing conventions will be closed. See [CONTRIBUTING.md](../../CONTRIBUTING.md). - type: textarea diff --git a/.github/workflows/marvin-label-triage.yml b/.github/workflows/marvin-label-triage.yml index aa357f733..80e21e9c9 100644 --- a/.github/workflows/marvin-label-triage.yml +++ b/.github/workflows/marvin-label-triage.yml @@ -49,7 +49,7 @@ jobs: PROMPT<