From 5dcdf79e48bf12f49c17b3cd1644c4327f8d84dc Mon Sep 17 00:00:00 2001 From: Kami Date: Wed, 7 Jan 2026 15:42:02 +1000 Subject: [PATCH 1/3] =?UTF-8?q?=E2=9C=A8=20Update=20issue=20templates?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/ISSUE_TEMPLATE/bug-report.yml | 112 ++++++++++++++++----- .github/ISSUE_TEMPLATE/feature-request.yml | 67 ++++++++++-- .github/ISSUE_TEMPLATE/suggest-icon.yml | 57 ++++++++--- 3 files changed, 185 insertions(+), 51 deletions(-) mode change 100644 => 100755 .github/ISSUE_TEMPLATE/bug-report.yml mode change 100644 => 100755 .github/ISSUE_TEMPLATE/feature-request.yml mode change 100644 => 100755 .github/ISSUE_TEMPLATE/suggest-icon.yml diff --git a/.github/ISSUE_TEMPLATE/bug-report.yml b/.github/ISSUE_TEMPLATE/bug-report.yml old mode 100644 new mode 100755 index 288e6e88..8c92e40c --- a/.github/ISSUE_TEMPLATE/bug-report.yml +++ b/.github/ISSUE_TEMPLATE/bug-report.yml @@ -5,81 +5,139 @@ labels: ["Bug"] body: - type: textarea attributes: - label: Bug Description - description: Provide a clear and concise description of this bug. + label: Bug description + description: Provide a clear and concise description of the bug. + placeholder: A brief summary of the problem and where it occurs. + validations: + required: true + + - type: dropdown + attributes: + label: Affected scope + description: What area is impacted? + options: + - UI + - Performance + - Crash / Freeze + - Data loss / Corruption + - Documentation + - Other validations: required: true - type: textarea attributes: - label: Steps To Reproduce - description: Provide steps to reproduce this bug. + label: Steps to reproduce + description: List the exact steps to reproduce the issue. placeholder: | - 1. [First Step] - 2. [Second Step] + 1. [First step] + 2. [Second step] 3. [and so on...] validations: required: true - - type: textarea + - type: dropdown attributes: - label: Expected Behavior - description: Provide a clear and concise description of what you expected to happen. + label: Reproducibility + description: How often does the issue occur? + options: + - Always + - Often (≥70%) + - Sometimes (30–70%) + - Rarely (<30%) + - Unable to reproduce again validations: required: true - type: textarea attributes: - label: Actual Behavior - description: Provide a clear and concise description of what happened. + label: Expected vs Actual behavior + description: | + Expected: I expected my icon to unlock when reaching the target number of Loops. + + Actual: The icon did not unlock when reaching the target number of Loops, I think it's because... validations: required: true - type: textarea attributes: label: Screenshots - description: Add screenshots to help explain this bug, if applicable. + description: Add screenshots to help explain the issue (if applicable). validations: required: false + - type: dropdown + attributes: + label: Severity + description: How severely does this affect you? + options: + - Blocker (cannot proceed) + - Critical (major functionality broken) + - Major (workaround exists) + - Minor (limited impact) + - Trivial (cosmetic) + validations: + required: true + - type: input attributes: - label: macOS Version - description: Apple Logo -> About This Mac - placeholder: | - [ex. Ventura 13.1] + label: macOS version + description: Apple Logo → About This Mac + placeholder: Sequoia 15.5 validations: required: true - type: input attributes: - label: Loop Version - description: You can find this in Loop\'s about window! - placeholder: | - [ex. Version 1.0.0 (246)] + label: Loop version + description: You can find this in Loop’s About window + placeholder: Version 1.4.0 (1581) + validations: + required: true + + - type: dropdown + attributes: + label: Did you try the development build? + description: In About, enable “Include development version,” then click “Check for updates.” + options: + - "Yes" + - "No" + - "There was a developer build? Let's try that." validations: required: true - type: textarea attributes: - label: Additional Context + label: Additional context description: Provide any additional information about this bug. + placeholder: | + - Logs or crash report (redact sensitive data) + - Related issues: #123, #456 + - Network/proxy/VPN details + - External display/monitor/usb-c dock etc. + - Keyboard layout/language + - Other relevant information validations: required: false - type: checkboxes attributes: - label: Final Checks + label: Final checks options: - - label: My issue is written in English + - label: My issue is written in English. required: true - - label: My issue title is descriptive + - label: My issue title is descriptive. required: true - - label: This is a single bug (multiple bugs should be reported individually) + - label: This is a single bug (multiple bugs should be reported individually). required: true - - label: I can help with fixing or developing this issue (tick if you can help). + - label: I have looked to see if this is a duplicate of another bug report. + required: true + - label: I can help with further investigation. + required: false + - label: I can help with developing a fix for this issue. required: false - type: markdown attributes: - value: Thank you for taking the time to report this bug! + value: | + Thank you for taking the time to report this bug! diff --git a/.github/ISSUE_TEMPLATE/feature-request.yml b/.github/ISSUE_TEMPLATE/feature-request.yml old mode 100644 new mode 100755 index 1770704b..357a047e --- a/.github/ISSUE_TEMPLATE/feature-request.yml +++ b/.github/ISSUE_TEMPLATE/feature-request.yml @@ -5,38 +5,83 @@ labels: ["Feature"] body: - type: textarea attributes: - label: Feature Request Description - description: Provide a clear and concise description of this feature request with any problems and solutions. + label: Feature Request Summary + description: Provide a concise description of the feature. + placeholder: Briefly describe what you want to achieve. validations: required: true - type: textarea attributes: - label: Screenshots - description: Add screenshots to help explain this feature request, if applicable. + label: Problem / Opportunity & Desired Solution + description: Describe the pain point, why it matters now, and how the feature should work from the user's perspective. + placeholder: | + Problem or Opportunity: + - Current behavior + - Why it matters now + Desired Solution / Implementation: + - How it should work + - What should happen + validations: + required: true + + - type: textarea + attributes: + label: Alternatives Considered + description: List any alternatives you considered. + placeholder: | + 1. Alternative A — why it falls short + 2. Alternative B — why it falls short + validations: + required: false + + - type: textarea + attributes: + label: Visuals or References + description: Add mockups, screenshots, or links to inspiration. + placeholder: Drag and drop files or paste URLs. validations: required: false - type: textarea attributes: label: Additional Context - description: Provide any additional information about this feature request. + description: Share any other relevant notes (logs, related issues, documentation). + placeholder: | + - Related issues: #123, #456 + - Other relevant information validations: required: false + - type: dropdown + attributes: + label: Priority + description: How urgent or valuable is this request? + options: + - High (mission critical) + - Medium (important but not blocking) + - Low (nice to have) + validations: + required: true + - type: checkboxes attributes: - label: Final Checks + label: Final checks options: - - label: My issue is written in English + - label: My issue is written in English. required: true - - label: My issue title is descriptive + - label: My issue title is descriptive. required: true - - label: This is a single feature request (multiple feature requests should be reported individually) + - label: This is a single feature request (multiple feature requests should be reported individually). required: true - - label: I can help with the improvement or development of this feature (tick if you can help) + - label: I have looked to see if this is a duplicate of another feature request. + required: true + - label: I can help with research or testing. + required: false + - label: I can help build this feature. required: false - type: markdown attributes: - value: Thank you for taking the time to report this feature request! + value: | + Thank you for taking the time to propose this feature! diff --git a/.github/ISSUE_TEMPLATE/suggest-icon.yml b/.github/ISSUE_TEMPLATE/suggest-icon.yml old mode 100644 new mode 100755 index 68121d2c..28f39b97 --- a/.github/ISSUE_TEMPLATE/suggest-icon.yml +++ b/.github/ISSUE_TEMPLATE/suggest-icon.yml @@ -1,33 +1,64 @@ name: Suggest New Icon description: Add your icon to Loop. -title: "🍱 Add [icon names]" +title: "🍱 Add [icon name]" labels: ["Feature"] body: - type: textarea attributes: - label: Icons - description: Drag your icons here. + label: Icon files + description: Drag and drop SVG/PNG assets directly into this field, or paste the URL of the icon. Also, attach the link or file used to create the icon (Figma, Sketch, etc.). + placeholder: Attach one icon per row or bundle them in a ZIP. Ensure your upload also includes the link or file used to create the icon (Figma, Sketch, etc.).. validations: required: true + - type: input + attributes: + label: Icon names + description: Provide the exact names that should appear in Loop. + placeholder: Blackhole, Summer, Mosaic + validations: + required: true + + - type: textarea + attributes: + label: Concept & meaning + description: Explain what each icon represents and why it is valuable. + placeholder: | + - Blackhole: Represents... + - Summer: Represents... + - Mosaic: Represents... + validations: + required: false + - type: textarea attributes: - label: Comments - description: Describe the significance of your icons. (what does it represent?) + label: Social Media handle + description: Input your username AND social media name to be attributed in the contribution list. If none is provided, the GitHub account that created the icon form will be used instead. validations: required: true - - type: markdown + - type: textarea attributes: - value: | - Please keep in mind that not all icons may be approved, as they do take up quite a bit of space in the app itself :) - Thank you for taking the time to make icons for Loop! + label: Additional context + description: Add references, mockups in situ, or related discussions. + validations: + required: false - type: checkboxes attributes: - label: Final Checks + label: Final checks options: - - label: My suggestion is written in English + - label: My suggestion is written in English. + required: true + - label: I am submitting an icon (this is not for icon requests). + required: true + - label: I own the rights to these assets or have permission to share them. required: true - - label: I am submitting an icon (this is not for icon requests) - required: true \ No newline at end of file + - label: I can iterate on the design if feedback is provided. + required: false + + - type: markdown + attributes: + value: | + Please keep in mind that not all icons may be approved, as they do take up quite a bit of space in the app itself. + Thank you for taking the time to make icons for Loop! From 15ccb94a190f8dd59382e887112611b8f41e6a3a Mon Sep 17 00:00:00 2001 From: Kai Azim Date: Tue, 6 Jan 2026 23:08:12 -0700 Subject: [PATCH 2/3] =?UTF-8?q?=F0=9F=93=84=20Title=20case,=20edit=20some?= =?UTF-8?q?=20sections?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/ISSUE_TEMPLATE/bug-report.yml | 24 ++++++------- .github/ISSUE_TEMPLATE/feature-request.yml | 2 +- .github/ISSUE_TEMPLATE/localisation.yml | 42 ---------------------- .github/ISSUE_TEMPLATE/suggest-icon.yml | 30 +++++++--------- 4 files changed, 26 insertions(+), 72 deletions(-) delete mode 100644 .github/ISSUE_TEMPLATE/localisation.yml diff --git a/.github/ISSUE_TEMPLATE/bug-report.yml b/.github/ISSUE_TEMPLATE/bug-report.yml index 8c92e40c..352e33d0 100755 --- a/.github/ISSUE_TEMPLATE/bug-report.yml +++ b/.github/ISSUE_TEMPLATE/bug-report.yml @@ -5,7 +5,7 @@ labels: ["Bug"] body: - type: textarea attributes: - label: Bug description + label: Bug Description description: Provide a clear and concise description of the bug. placeholder: A brief summary of the problem and where it occurs. validations: @@ -13,10 +13,10 @@ body: - type: dropdown attributes: - label: Affected scope + label: Affected Scope description: What area is impacted? options: - - UI + - User interface - Performance - Crash / Freeze - Data loss / Corruption @@ -27,7 +27,7 @@ body: - type: textarea attributes: - label: Steps to reproduce + label: Steps to Reproduce description: List the exact steps to reproduce the issue. placeholder: | 1. [First step] @@ -51,7 +51,7 @@ body: - type: textarea attributes: - label: Expected vs Actual behavior + label: Expected vs Actual Behavior description: | Expected: I expected my icon to unlock when reaching the target number of Loops. @@ -61,8 +61,8 @@ body: - type: textarea attributes: - label: Screenshots - description: Add screenshots to help explain the issue (if applicable). + label: Screen Recordings / Screenshots + description: Add screen recordings or screenshots to help explain the issue (if applicable). validations: required: false @@ -81,7 +81,7 @@ body: - type: input attributes: - label: macOS version + label: macOS Version description: Apple Logo → About This Mac placeholder: Sequoia 15.5 validations: @@ -89,7 +89,7 @@ body: - type: input attributes: - label: Loop version + label: Loop Version description: You can find this in Loop’s About window placeholder: Version 1.4.0 (1581) validations: @@ -97,7 +97,7 @@ body: - type: dropdown attributes: - label: Did you try the development build? + label: Did You Try the Development Build? description: In About, enable “Include development version,” then click “Check for updates.” options: - "Yes" @@ -108,7 +108,7 @@ body: - type: textarea attributes: - label: Additional context + label: Additional Context description: Provide any additional information about this bug. placeholder: | - Logs or crash report (redact sensitive data) @@ -122,7 +122,7 @@ body: - type: checkboxes attributes: - label: Final checks + label: Final Checks options: - label: My issue is written in English. required: true diff --git a/.github/ISSUE_TEMPLATE/feature-request.yml b/.github/ISSUE_TEMPLATE/feature-request.yml index 357a047e..a14a901c 100755 --- a/.github/ISSUE_TEMPLATE/feature-request.yml +++ b/.github/ISSUE_TEMPLATE/feature-request.yml @@ -78,7 +78,7 @@ body: required: true - label: I can help with research or testing. required: false - - label: I can help build this feature. + - label: I can help code this feature. required: false - type: markdown diff --git a/.github/ISSUE_TEMPLATE/localisation.yml b/.github/ISSUE_TEMPLATE/localisation.yml deleted file mode 100644 index 8f8974b1..00000000 --- a/.github/ISSUE_TEMPLATE/localisation.yml +++ /dev/null @@ -1,42 +0,0 @@ -name: Loop Localisation -description: Edit, request or localise Loop in your language. -title: "🌐 [Title here]" -labels: ["Localization"] -body: - - type: textarea - attributes: - label: What language do you intend to add or change? - description: Provide a clear and concise description of your added or changed language. Clearly indicate if you need a localized file provided or if you can do this on your own. - validations: - required: true - - - type: textarea - attributes: - label: Additional Context - description: Provide any additional information about this localisation request. - validations: - required: false - - - type: textarea - attributes: - label: Missed localisation - description: Fill this out if you were unable to localize certain parts of the file - validations: - required: false - - - type: checkboxes - attributes: - label: Final Checks - options: - - label: My localisation request is written in English - required: true - - label: My localisation request title is descriptive - required: true - - label: This is a single localisation request (multiple localisation request should be requested individually) - required: true - - label: I need a localised file for my language (tick this if needed) - required: false - - - type: markdown - attributes: - value: Thank you for taking the time to report this localisation request! diff --git a/.github/ISSUE_TEMPLATE/suggest-icon.yml b/.github/ISSUE_TEMPLATE/suggest-icon.yml index 28f39b97..7e1819b0 100755 --- a/.github/ISSUE_TEMPLATE/suggest-icon.yml +++ b/.github/ISSUE_TEMPLATE/suggest-icon.yml @@ -5,41 +5,37 @@ labels: ["Feature"] body: - type: textarea attributes: - label: Icon files - description: Drag and drop SVG/PNG assets directly into this field, or paste the URL of the icon. Also, attach the link or file used to create the icon (Figma, Sketch, etc.). - placeholder: Attach one icon per row or bundle them in a ZIP. Ensure your upload also includes the link or file used to create the icon (Figma, Sketch, etc.).. + label: Icon Files + description: Drag and drop `.icon`/`.svg`/`.png` assets directly into this field, or paste the URL of the icon. Also, attach the link or file used to create the icon (Figma, Sketch, etc.). + placeholder: Attach one file per row or bundle them in a ZIP. Ensure you include the link or file used to create the icon (Figma, Sketch, etc.).. validations: required: true - type: input attributes: - label: Icon names - description: Provide the exact names that should appear in Loop. - placeholder: Blackhole, Summer, Mosaic + label: Icon Name + description: Provide the exact name of the icon that should appear in Loop. + placeholder: Black Hole validations: required: true - type: textarea attributes: - label: Concept & meaning - description: Explain what each icon represents and why it is valuable. - placeholder: | - - Blackhole: Represents... - - Summer: Represents... - - Mosaic: Represents... + label: Concept & Meaning + description: Explain what this icon represents and why it is valuable. validations: required: false - type: textarea attributes: - label: Social Media handle - description: Input your username AND social media name to be attributed in the contribution list. If none is provided, the GitHub account that created the icon form will be used instead. + label: Preferred Social Media Handle + description: Input your social media link to be attributed in the contribution list. If none is provided, the GitHub account associateed with this issue will be used instead. validations: - required: true + required: false - type: textarea attributes: - label: Additional context + label: Additional Context description: Add references, mockups in situ, or related discussions. validations: required: false @@ -55,7 +51,7 @@ body: - label: I own the rights to these assets or have permission to share them. required: true - label: I can iterate on the design if feedback is provided. - required: false + required: true - type: markdown attributes: From 585a32fd426f7ec8b92b556bb99fa71f284e601d Mon Sep 17 00:00:00 2001 From: Kai Azim Date: Tue, 6 Jan 2026 23:10:43 -0700 Subject: [PATCH 3/3] =?UTF-8?q?=F0=9F=93=84=20Final=20changes?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/ISSUE_TEMPLATE/feature-request.yml | 2 +- .github/ISSUE_TEMPLATE/suggest-icon.yml | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/feature-request.yml b/.github/ISSUE_TEMPLATE/feature-request.yml index a14a901c..6403073a 100755 --- a/.github/ISSUE_TEMPLATE/feature-request.yml +++ b/.github/ISSUE_TEMPLATE/feature-request.yml @@ -66,7 +66,7 @@ body: - type: checkboxes attributes: - label: Final checks + label: Final Checks options: - label: My issue is written in English. required: true diff --git a/.github/ISSUE_TEMPLATE/suggest-icon.yml b/.github/ISSUE_TEMPLATE/suggest-icon.yml index 7e1819b0..7a9cc413 100755 --- a/.github/ISSUE_TEMPLATE/suggest-icon.yml +++ b/.github/ISSUE_TEMPLATE/suggest-icon.yml @@ -29,7 +29,7 @@ body: - type: textarea attributes: label: Preferred Social Media Handle - description: Input your social media link to be attributed in the contribution list. If none is provided, the GitHub account associateed with this issue will be used instead. + description: Provide a social media link to be credited in the contribution list. If left blank, your GitHub account associated with this issue will be used instead. validations: required: false @@ -42,7 +42,7 @@ body: - type: checkboxes attributes: - label: Final checks + label: Final Checks options: - label: My suggestion is written in English. required: true