From 4f2d787a3ca1f6212636bc608cb921be9b8eb4f0 Mon Sep 17 00:00:00 2001 From: Adam Date: Thu, 24 Jul 2025 20:35:16 +0100 Subject: [PATCH 1/7] bug-reports.yml for MacOS --- .github/ISSUE_TEMPLATE/bug-reports.yml | 92 +++++++++++--------------- 1 file changed, 39 insertions(+), 53 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/bug-reports.yml b/.github/ISSUE_TEMPLATE/bug-reports.yml index 4de0ddd..02acad8 100644 --- a/.github/ISSUE_TEMPLATE/bug-reports.yml +++ b/.github/ISSUE_TEMPLATE/bug-reports.yml @@ -9,56 +9,39 @@ body: value: | Thank you for helping us improve! Please provide as much detail as possible to ensure we can address the issue effectively. - type: dropdown - id: distribution + id: macos-version attributes: - label: Distribution + label: macOS Version multiple: false - description: Select the Linux distribution you are using. + description: Select your macOS version. options: - - Arch - - Ubuntu - - Fedora - - Debian - - openSUSE + - macOS Sequoia (15.x) + - macOS Sonoma (14.x) + - macOS Ventura (13.x) + - macOS Monterey (12.x) + - macOS Big Sur (11.x) + - macOS Catalina (10.15) + - macOS Mojave (10.14) - Other validations: required: true - type: input - id: specify-distribution + id: macos-version-specific attributes: - label: Specify Distribution (if "Other" selected) - description: Enter the name of your Linux distribution. - placeholder: e.g., Manjaro, Pop!_OS - - type: dropdown - id: de-wm - attributes: - label: Desktop Environment / Window Manager - multiple: false - description: Select your desktop environment or window manager. - options: - - GNOME - - KDE Plasma - - XFCE - - Hyprland - - i3 - - Other + label: Specific macOS Version + description: Enter your exact macOS version (e.g., 15.1.1, 14.2.1). + placeholder: e.g., 15.1.1, 14.2.1 validations: required: true - - type: input - id: specify-de-wm - attributes: - label: Specify Desktop Environment/Window Manager (if "Other" selected) - description: Enter the name of your desktop environment or window manager. - placeholder: e.g., LXQt, Openbox - type: dropdown - id: windowing-system + id: mac-architecture attributes: - label: Windowing System + label: Mac Architecture multiple: false - description: Specify whether you are using X11 or Wayland. + description: Select your Mac's processor type. options: - - X11 - - Wayland + - Apple Silicon / ARM + - Intel / x86 validations: required: true - type: input @@ -88,19 +71,19 @@ body: description: Enter the branch name. placeholder: e.g., feature/new-feature - type: textarea - id: describe-bug + id: description attributes: - label: Describe the bug + label: Description description: | - Provide a clear and concise description of what the bug is. + Provide a clear and concise description of the bug or issue. placeholder: Describe the issue in detail. validations: required: true - type: textarea - id: reproduce-steps + id: reproduction-steps attributes: - label: Steps to reproduce - description: Steps to reproduce the behavior. + label: Reproduction Steps + description: Detailed steps to reproduce the behavior. placeholder: | 1. Go to '...' 2. Click on '...' @@ -109,27 +92,30 @@ body: validations: required: true - type: textarea - id: expected-behavior + id: actual-result attributes: - label: Expected behavior + label: Actual Result description: | - A clear and concise description of what you expected to happen. - placeholder: Explain the expected outcome. + What actually happened when you followed the reproduction steps. + placeholder: Describe what actually occurred. validations: required: true - type: textarea - id: additional-context + id: expected-result attributes: - label: Additional context + label: Expected Result description: | - Add any other context or information about the problem here. - placeholder: Include any related logs, error messages, or configurations. + A clear and concise description of what you expected to happen. + placeholder: Explain the expected outcome. + validations: + required: true - type: textarea - id: screenshots + id: supporting-information attributes: - label: Screenshots + label: Supporting Information description: | - If applicable, add screenshots to help explain your problem. Provide links or attach images in the comments after submitting the issue. + Add any other context, logs, error messages, screenshots, or configurations that might help diagnose the issue. + placeholder: Include any related logs, error messages, screenshots, or configurations. - type: checkboxes id: checklist attributes: From 533bd9731b7c1ffcba9e1c010a6002147f9dbcfb Mon Sep 17 00:00:00 2001 From: Adam Date: Thu, 24 Jul 2025 20:44:06 +0100 Subject: [PATCH 2/7] removed placeholder '[Bug]: ' from title field --- .github/ISSUE_TEMPLATE/bug-reports.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/bug-reports.yml b/.github/ISSUE_TEMPLATE/bug-reports.yml index 02acad8..44902c9 100644 --- a/.github/ISSUE_TEMPLATE/bug-reports.yml +++ b/.github/ISSUE_TEMPLATE/bug-reports.yml @@ -1,6 +1,6 @@ name: Bug Report description: Report a bug or issue to help us improve. -title: "[Bug]: " +title: "" labels: ["bug"] assignees: [] body: From db0fb292b9cbb0da33fa39ceb371dd4bf1304732 Mon Sep 17 00:00:00 2001 From: Adam Date: Thu, 24 Jul 2025 20:46:37 +0100 Subject: [PATCH 3/7] Added value back into title as required for some reason --- .github/ISSUE_TEMPLATE/bug-reports.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/bug-reports.yml b/.github/ISSUE_TEMPLATE/bug-reports.yml index 44902c9..152eea0 100644 --- a/.github/ISSUE_TEMPLATE/bug-reports.yml +++ b/.github/ISSUE_TEMPLATE/bug-reports.yml @@ -1,6 +1,6 @@ name: Bug Report description: Report a bug or issue to help us improve. -title: "" +title: "Bug Report" labels: ["bug"] assignees: [] body: From dcbe843774828f839e6266343db47903d821ad70 Mon Sep 17 00:00:00 2001 From: Adam Date: Thu, 24 Jul 2025 20:48:43 +0100 Subject: [PATCH 4/7] Reverting to previous '[Bug]: ' value --- .github/ISSUE_TEMPLATE/bug-reports.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/bug-reports.yml b/.github/ISSUE_TEMPLATE/bug-reports.yml index 152eea0..02acad8 100644 --- a/.github/ISSUE_TEMPLATE/bug-reports.yml +++ b/.github/ISSUE_TEMPLATE/bug-reports.yml @@ -1,6 +1,6 @@ name: Bug Report description: Report a bug or issue to help us improve. -title: "Bug Report" +title: "[Bug]: " labels: ["bug"] assignees: [] body: From 783fb6120f9cc1fa70b61ee8f71c959df8b4b8ab Mon Sep 17 00:00:00 2001 From: Adam Date: Thu, 24 Jul 2025 21:15:03 +0100 Subject: [PATCH 5/7] Slightly nicer UX --- .github/ISSUE_TEMPLATE/bug-reports.yml | 24 ++++++++++-------------- 1 file changed, 10 insertions(+), 14 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/bug-reports.yml b/.github/ISSUE_TEMPLATE/bug-reports.yml index 02acad8..ea16f25 100644 --- a/.github/ISSUE_TEMPLATE/bug-reports.yml +++ b/.github/ISSUE_TEMPLATE/bug-reports.yml @@ -13,15 +13,14 @@ body: attributes: label: macOS Version multiple: false - description: Select your macOS version. options: - - macOS Sequoia (15.x) - - macOS Sonoma (14.x) - - macOS Ventura (13.x) - - macOS Monterey (12.x) - - macOS Big Sur (11.x) - - macOS Catalina (10.15) - - macOS Mojave (10.14) + - Sequoia (15.x) + - Sonoma (14.x) + - Ventura (13.x) + - Monterey (12.x) + - Big Sur (11.x) + - Catalina (10.15) + - Mojave (10.14) - Other validations: required: true @@ -36,9 +35,8 @@ body: - type: dropdown id: mac-architecture attributes: - label: Mac Architecture + label: Mac Processor Type multiple: false - description: Select your Mac's processor type. options: - Apple Silicon / ARM - Intel / x86 @@ -85,10 +83,8 @@ body: label: Reproduction Steps description: Detailed steps to reproduce the behavior. placeholder: | - 1. Go to '...' - 2. Click on '...' - 3. Scroll down to '...' - 4. See error + 1. Tried to use script '...' + 2. It ran until this point '...' validations: required: true - type: textarea From 813a697277be163f88bfa41324624832e230b173 Mon Sep 17 00:00:00 2001 From: Adam Date: Thu, 24 Jul 2025 21:21:42 +0100 Subject: [PATCH 6/7] Tidying up wording --- .github/ISSUE_TEMPLATE/bug-reports.yml | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/bug-reports.yml b/.github/ISSUE_TEMPLATE/bug-reports.yml index ea16f25..9d60c69 100644 --- a/.github/ISSUE_TEMPLATE/bug-reports.yml +++ b/.github/ISSUE_TEMPLATE/bug-reports.yml @@ -29,7 +29,6 @@ body: attributes: label: Specific macOS Version description: Enter your exact macOS version (e.g., 15.1.1, 14.2.1). - placeholder: e.g., 15.1.1, 14.2.1 validations: required: true - type: dropdown @@ -81,10 +80,10 @@ body: id: reproduction-steps attributes: label: Reproduction Steps - description: Detailed steps to reproduce the behavior. + description: Detailed steps that reproduce the bug. placeholder: | - 1. Tried to use script '...' - 2. It ran until this point '...' + 1. Ran the '...' script + 2. It ran until '...' validations: required: true - type: textarea From bad2ee061c6b2243f50088969e3f84500bb92eb7 Mon Sep 17 00:00:00 2001 From: Adam Date: Thu, 24 Jul 2025 21:34:36 +0100 Subject: [PATCH 7/7] More tidying up wording --- .github/ISSUE_TEMPLATE/bug-reports.yml | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/bug-reports.yml b/.github/ISSUE_TEMPLATE/bug-reports.yml index 9d60c69..aec84cf 100644 --- a/.github/ISSUE_TEMPLATE/bug-reports.yml +++ b/.github/ISSUE_TEMPLATE/bug-reports.yml @@ -14,6 +14,7 @@ body: label: macOS Version multiple: false options: + - Tahoe (26.x) - Sequoia (15.x) - Sonoma (14.x) - Ventura (13.x) @@ -82,8 +83,9 @@ body: label: Reproduction Steps description: Detailed steps that reproduce the bug. placeholder: | - 1. Ran the '...' script - 2. It ran until '...' + 1. I ran the '...' script + 2. It ran successfully and did these '...' things + 3. But then... (go to next field) validations: required: true - type: textarea