Files
SnapOtter/.github/ISSUE_TEMPLATE/bug_report.yml
T
SnapOtter 609cd6b609 chore(github): redesign issue intake forms and routing
Overhaul the bug report form and restructure issue intake for 2.0:

- Bug report: split actual vs expected behavior, add Affected area and
  Specific tool fields for triage, replace the self-defeating required
  "latest version" checkbox with a Version field that accepts a tag,
  release, or commit (always answerable from any install), modernize
  Docker guidance to the Compose stack, add Host OS, and fix the
  previously required image-tag field that source users could not fill.
- Move feature requests to GitHub Discussions: delete the feature_request
  issue form, rename the orphaned discussion form to ideas.yml so it binds
  to the built-in Ideas category, and point config.yml there.
- Add Translation and Documentation issue forms routed to existing labels.
- Remove the roadmap-update discussion form (roadmap is private).
- Reconcile CONTRIBUTING.md, SUPPORT.md, and the published docs
  contributing guide with the new routing.
2026-06-17 14:21:18 +08:00

160 lines
4.2 KiB
YAML

name: Bug Report
description: Something isn't working as expected
title: "[Bug] "
labels: ["bug"]
body:
- type: markdown
attributes:
value: |
Thanks for taking the time to file a bug. The more detail you give, especially how you run SnapOtter and how to reproduce it, the faster we can help.
- type: checkboxes
id: checklist
attributes:
label: Before submitting
options:
- label: I searched existing issues and didn't find a duplicate
required: true
- label: I've tried the latest version to confirm it isn't already fixed
required: false
- type: textarea
id: what-happened
attributes:
label: What happened?
description: Describe the actual behavior you saw.
placeholder: |
When I resize an image, the downloaded file is 0 bytes.
validations:
required: true
- type: textarea
id: expected
attributes:
label: Expected behavior
description: What did you expect to happen instead?
placeholder: |
The resized image downloads normally.
validations:
required: true
- type: textarea
id: steps
attributes:
label: Steps to reproduce
description: How can we reproduce this? Number each step.
placeholder: |
1. Upload a PNG image
2. Select the "Resize" tool
3. Set width to 500
4. Click "Process"
5. Downloaded file is 0 bytes
validations:
required: true
- type: dropdown
id: area
attributes:
label: Affected area
description: Which part of SnapOtter does this involve?
options:
- Image tools
- Video tools
- Audio tools
- PDF tools
- Data tools
- Image editor
- Pipelines / automation
- File library
- Account / login
- Installation / Docker / startup
- Other / not sure
validations:
required: true
- type: input
id: tool
attributes:
label: Specific tool
description: If this is about one tool, which one? Leave blank if it isn't tool-specific.
placeholder: "e.g. resize, background-remover, pdf-merge"
- type: dropdown
id: install-method
attributes:
label: How are you running SnapOtter?
options:
- Docker Compose
- Running from source (pnpm dev)
- Other (describe in deployment details)
validations:
required: true
- type: input
id: version
attributes:
label: Version
description: Image tag, release version, or git commit. Running from source? Paste the commit hash.
placeholder: "e.g. latest, 2.0.0, or a1b2c3d"
validations:
required: true
- type: textarea
id: deployment
attributes:
label: Deployment details
description: "Your compose file or run command, with secrets redacted. Write N/A if running from source. Strongly recommended for Docker issues."
render: shell
- type: dropdown
id: arch
attributes:
label: Host architecture
options:
- AMD64 (Intel/AMD)
- ARM64 (Apple Silicon, Raspberry Pi)
validations:
required: true
- type: dropdown
id: host-os
attributes:
label: Host OS
options:
- Linux (native)
- macOS (Docker Desktop)
- Windows (Docker Desktop)
- Windows (WSL2)
- Other / running from source
validations:
required: true
- type: input
id: browser
attributes:
label: Browser
description: Only if the bug is in the web UI.
placeholder: "e.g. Chrome 130, Firefox 133, Safari 18"
- type: textarea
id: logs
attributes:
label: Logs
description: "Relevant logs, secrets redacted. For Compose: docker compose logs app (or postgres / redis)."
render: shell
- type: textarea
id: screenshots
attributes:
label: Screenshots
description: If applicable, add screenshots to help explain the problem.
- type: dropdown
id: willing-to-fix
attributes:
label: Would you like to contribute a fix?
description: If yes, we can assign this issue to you. See CONTRIBUTING.md for the PR process.
options:
- "No, just reporting"
- "Yes, I'd like to submit a PR"