Skip to content

Issue Creation

When to Use

When creating a new issue on drupal.org and AI tools were used in any part of the process — researching the problem, writing the summary, analyzing code, or drafting a patch.

Decision: AI Disclosure During Issue Creation

Issue Activity AI Involvement Required Disclosure
Researched the bug using AI AI analyzed a backtrace or suggested cause Check "AI Assisted Issue"
Drafted issue summary with AI AI helped write the description Check "AI Assisted Issue"
Created steps to reproduce with AI AI suggested test scenarios Check "AI Assisted Issue"
Attached a patch written with AI AI generated or assisted with code Check appropriate code checkbox too
No AI used in the issue Entirely human-written No AI checkboxes needed

Pattern: Issue Creation Workflow

  1. Research the problem — If AI helps analyze code, backtraces, or suggest root causes, note this for disclosure
  2. Write the issue title — Clear, specific, descriptive. AI can help draft but you must verify accuracy
  3. Set metadata — Component, priority, category, version. These must be accurate regardless of who researched them
  4. Write the description — Problem statement, steps to reproduce, expected vs actual behavior. If AI drafted any part, disclose
  5. Check AI disclosure boxes — Be honest about which parts AI helped with
  6. Verify steps to reproduce — Even if AI drafted them, YOU must verify they actually reproduce the issue. Do not submit unverified reproduction steps.

Pattern: What AI Can Help With

Good Use Caution Required
Analyzing a backtrace to identify the failing component AI may misidentify the root cause — verify
Drafting a clear issue summary from your notes AI may add assumptions not in your notes — review
Suggesting related issues or documentation AI may hallucinate issue numbers — verify every link
Helping format the issue with proper markdown Low risk — still review

Common Mistakes

  • Submitting AI-drafted steps to reproduce without testing them — The steps must actually work. AI frequently generates plausible but incorrect reproduction steps.
  • Letting AI set the priority — AI cannot assess the impact on the Drupal ecosystem. Set priority based on your understanding.
  • Using AI-hallucinated issue numbers — AI may reference issues that don't exist. Verify every cross-reference.
  • Forgetting to disclose AI involvement in issue text — If AI helped write any part of the issue, check "AI Assisted Issue"

See Also