Appendix M: GitHub Issue Management - ApertureViewer/Aperture-Opertations-Manual GitHub Wiki

GitHub Issue Management

• Triage: Acknowledge new issues promptly. Thank reporter. Apply relevant labels (bug, enhancement, feature-request, documentation, ui, performance, post-processing, stars, phototools, etc.).
• Clarification: If unclear, politely ask for more information (steps to reproduce, logs, screenshots, settings). Use needs-info label.
• Investigation: Attempt to reproduce bugs. Identify root cause. Check for duplicates.
• Communication: Keep the issue updated with progress or decisions.
• Linking: When committing code related to an issue, reference Resolves #issue_number or Fixes #issue_number in the commit message (ideally in the body/footer) or PR description to enable auto-linking and auto-closing.
• Closure: Close issues when:
  • Fixed and merged (comment with PR link and target release).
  • Determined to be wontfix (explain why).
  • Identified as duplicate (link to original).
  • invalid or cannot-reproduce (after attempting to get more info).