From b1e4efdd0b5caa2ebc2bdf13abe6b8b7c3178912 Mon Sep 17 00:00:00 2001 From: pax Date: Fri, 10 Apr 2026 22:54:04 -0500 Subject: [PATCH] add GitHub issue templates --- .github/ISSUE_TEMPLATE/bug_report.yaml | 55 +++++++++++++++ .github/ISSUE_TEMPLATE/config.yml | 8 +++ .github/ISSUE_TEMPLATE/docs.yaml | 22 ++++++ .github/ISSUE_TEMPLATE/feature_request.yaml | 28 ++++++++ .github/ISSUE_TEMPLATE/hyprland_wayland.yaml | 70 +++++++++++++++++++ .github/ISSUE_TEMPLATE/performance.yaml | 72 ++++++++++++++++++++ .github/ISSUE_TEMPLATE/site_support.yaml | 26 +++++++ .github/ISSUE_TEMPLATE/theme_submission.yaml | 30 ++++++++ .github/ISSUE_TEMPLATE/ux_feedback.yaml | 39 +++++++++++ 9 files changed, 350 insertions(+) create mode 100644 .github/ISSUE_TEMPLATE/bug_report.yaml create mode 100644 .github/ISSUE_TEMPLATE/config.yml create mode 100644 .github/ISSUE_TEMPLATE/docs.yaml create mode 100644 .github/ISSUE_TEMPLATE/feature_request.yaml create mode 100644 .github/ISSUE_TEMPLATE/hyprland_wayland.yaml create mode 100644 .github/ISSUE_TEMPLATE/performance.yaml create mode 100644 .github/ISSUE_TEMPLATE/site_support.yaml create mode 100644 .github/ISSUE_TEMPLATE/theme_submission.yaml create mode 100644 .github/ISSUE_TEMPLATE/ux_feedback.yaml diff --git a/.github/ISSUE_TEMPLATE/bug_report.yaml b/.github/ISSUE_TEMPLATE/bug_report.yaml new file mode 100644 index 0000000..81a6a33 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.yaml @@ -0,0 +1,55 @@ +name: Bug Report +about: Something broken or misbehaving +title: "[BUG] " +labels: ["bug"] +body: + - type: textarea + id: summary + attributes: + label: Summary + description: What's broken? + validations: + required: true + - type: textarea + id: repro + attributes: + label: Steps to reproduce + value: | + 1. + 2. + 3. + validations: + required: true + - type: textarea + id: expected + attributes: + label: Expected vs actual behavior + validations: + required: true + - type: dropdown + id: os + attributes: + label: OS + options: [Linux, Windows, Other] + validations: + required: true + - type: input + id: version + attributes: + label: booru-viewer version / commit + validations: + required: true + - type: input + id: python + attributes: + label: Python & PySide6 version + - type: dropdown + id: backend + attributes: + label: Booru backend + options: [Danbooru, Gelbooru, Safebooru, e621, Other] + - type: textarea + id: logs + attributes: + label: Logs / traceback + render: shell diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..0a97af5 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,8 @@ +blank_issues_enabled: false +contact_links: + - name: Questions and general discussion + url: https://github.com/pxlwh/booru-viewer/discussions + about: For usage questions, setup help, and general chat that isn't a bug + - name: Gitea mirror + url: https://git.pax.moe/pax/booru-viewer + about: Primary development repo — same codebase, also accepts issues diff --git a/.github/ISSUE_TEMPLATE/docs.yaml b/.github/ISSUE_TEMPLATE/docs.yaml new file mode 100644 index 0000000..1792859 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/docs.yaml @@ -0,0 +1,22 @@ +name: Documentation Issue +about: Typos, unclear sections, missing docs, broken links +title: "[DOCS] " +labels: ["documentation"] +body: + - type: input + id: file + attributes: + label: File or page + description: README.md, themes/README.md, HYPRLAND.md, KEYBINDS.md, in-app help, etc. + validations: + required: true + - type: textarea + id: problem + attributes: + label: What's wrong or missing? + validations: + required: true + - type: textarea + id: suggestion + attributes: + label: Suggested fix or addition diff --git a/.github/ISSUE_TEMPLATE/feature_request.yaml b/.github/ISSUE_TEMPLATE/feature_request.yaml new file mode 100644 index 0000000..03db644 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request.yaml @@ -0,0 +1,28 @@ +name: Feature Request +about: Suggest a new feature or enhancement +title: "[FEAT] " +labels: ["enhancement"] +body: + - type: textarea + id: problem + attributes: + label: Problem + description: What's the use case or pain point? + validations: + required: true + - type: textarea + id: proposal + attributes: + label: Proposed solution + validations: + required: true + - type: textarea + id: alternatives + attributes: + label: Alternatives considered + - type: checkboxes + id: scope + attributes: + label: Scope check + options: + - label: I've checked this isn't already implemented or tracked diff --git a/.github/ISSUE_TEMPLATE/hyprland_wayland.yaml b/.github/ISSUE_TEMPLATE/hyprland_wayland.yaml new file mode 100644 index 0000000..ff414af --- /dev/null +++ b/.github/ISSUE_TEMPLATE/hyprland_wayland.yaml @@ -0,0 +1,70 @@ +name: Hyprland / Wayland Issue +about: Compositor-specific issues (window positioning, popout math, Waybar, multi-monitor) +title: "[HYPR] " +labels: ["hyprland", "wayland"] +body: + - type: textarea + id: summary + attributes: + label: What's happening? + description: Describe the compositor-specific behavior you're seeing + validations: + required: true + - type: dropdown + id: compositor + attributes: + label: Compositor + options: [Hyprland, Sway, KDE/KWin Wayland, GNOME/Mutter Wayland, Other Wayland, Other] + validations: + required: true + - type: input + id: compositor_version + attributes: + label: Compositor version + description: e.g. Hyprland v0.42.0 + - type: dropdown + id: monitors + attributes: + label: Monitor setup + options: [Single monitor, Dual monitor, 3+ monitors, Mixed scaling, Mixed refresh rates] + - type: dropdown + id: area + attributes: + label: What area is affected? + options: + - Main window geometry / position + - Popout window positioning + - Popout aspect-ratio lock + - Popout anchor (resize pivot) + - Context menu / popup positioning + - Waybar exclusive zone handling + - Fullscreen (F11) + - Privacy screen overlay + - Other + validations: + required: true + - type: textarea + id: envvars + attributes: + label: Relevant env vars set + description: BOORU_VIEWER_NO_HYPR_RULES, BOORU_VIEWER_NO_POPOUT_ASPECT_LOCK, etc. + placeholder: "BOORU_VIEWER_NO_HYPR_RULES=1" + render: shell + - type: textarea + id: windowrules + attributes: + label: Any windowrules targeting booru-viewer? + description: Paste relevant rules from your compositor config + render: shell + - type: textarea + id: hyprctl + attributes: + label: hyprctl output (if applicable) + description: "`hyprctl monitors -j`, `hyprctl clients -j` filtered to booru-viewer" + render: json + - type: input + id: version + attributes: + label: booru-viewer version / commit + validations: + required: true diff --git a/.github/ISSUE_TEMPLATE/performance.yaml b/.github/ISSUE_TEMPLATE/performance.yaml new file mode 100644 index 0000000..127133b --- /dev/null +++ b/.github/ISSUE_TEMPLATE/performance.yaml @@ -0,0 +1,72 @@ +name: Performance Issue +about: Slowdowns, lag, high memory/CPU, UI freezes (distinct from broken features) +title: "[PERF] " +labels: ["performance"] +body: + - type: textarea + id: summary + attributes: + label: What's slow? + description: Describe what feels sluggish and what you'd expect + validations: + required: true + - type: dropdown + id: area + attributes: + label: What area? + options: + - Grid scroll / infinite scroll + - Thumbnail loading + - Search / API requests + - Image preview / pan-zoom + - Video playback + - Popout open / close + - Popout navigation + - Settings / dialogs + - Startup + - Other + validations: + required: true + - type: textarea + id: repro + attributes: + label: Steps to reproduce + value: | + 1. + 2. + 3. + validations: + required: true + - type: input + id: timings + attributes: + label: Approximate timings + description: How long does the slow operation take? How long would you expect? + - type: input + id: library_size + attributes: + label: Library / bookmark size + description: Number of saved files and/or bookmarks, if relevant + - type: dropdown + id: os + attributes: + label: OS + options: [Linux, Windows, Other] + validations: + required: true + - type: input + id: hardware + attributes: + label: Hardware (CPU / RAM / GPU) + - type: textarea + id: logs + attributes: + label: Relevant DEBUG logs + description: Launch with Ctrl+L open and reproduce — paste anything that looks slow + render: shell + - type: input + id: version + attributes: + label: booru-viewer version / commit + validations: + required: true diff --git a/.github/ISSUE_TEMPLATE/site_support.yaml b/.github/ISSUE_TEMPLATE/site_support.yaml new file mode 100644 index 0000000..b2cb9eb --- /dev/null +++ b/.github/ISSUE_TEMPLATE/site_support.yaml @@ -0,0 +1,26 @@ +name: Site Support Request +about: Request support for a new booru backend +title: "[SITE] " +labels: ["site-support"] +body: + - type: input + id: site + attributes: + label: Site name and URL + validations: + required: true + - type: dropdown + id: api + attributes: + label: API type + options: [Danbooru-compatible, Gelbooru-compatible, Moebooru, Shimmie2, Unknown, Other] + validations: + required: true + - type: input + id: api_docs + attributes: + label: Link to API documentation (if any) + - type: textarea + id: notes + attributes: + label: Auth, rate limits, or quirks worth knowing diff --git a/.github/ISSUE_TEMPLATE/theme_submission.yaml b/.github/ISSUE_TEMPLATE/theme_submission.yaml new file mode 100644 index 0000000..217881d --- /dev/null +++ b/.github/ISSUE_TEMPLATE/theme_submission.yaml @@ -0,0 +1,30 @@ +name: Theme Submission +about: Submit a palette for inclusion +title: "[THEME] " +labels: ["theme"] +body: + - type: input + id: name + attributes: + label: Theme name + validations: + required: true + - type: textarea + id: palette + attributes: + label: Palette file contents + description: Paste the full @palette block or the complete .qss file + render: css + validations: + required: true + - type: input + id: screenshot + attributes: + label: Screenshot URL + - type: checkboxes + id: license + attributes: + label: Licensing + options: + - label: I'm okay with this being distributed under the project's license + required: true diff --git a/.github/ISSUE_TEMPLATE/ux_feedback.yaml b/.github/ISSUE_TEMPLATE/ux_feedback.yaml new file mode 100644 index 0000000..34fd65c --- /dev/null +++ b/.github/ISSUE_TEMPLATE/ux_feedback.yaml @@ -0,0 +1,39 @@ +name: UX Feedback +about: Non-bug UX suggestions, workflow friction, small polish +title: "[UX] " +labels: ["ux"] +body: + - type: textarea + id: context + attributes: + label: What were you trying to do? + description: The workflow or action where the friction happened + validations: + required: true + - type: textarea + id: friction + attributes: + label: What felt awkward or wrong? + validations: + required: true + - type: textarea + id: suggestion + attributes: + label: What would feel better? + description: Optional — a rough idea is fine + - type: dropdown + id: area + attributes: + label: Area + options: + - Grid / thumbnails + - Preview pane + - Popout window + - Top bar / filters + - Search + - Bookmarks + - Library + - Settings + - Keyboard shortcuts + - Theming + - Other