From 1a5f5a8e779a2d2339342673d0e4c3ca9cba1fc4 Mon Sep 17 00:00:00 2001 From: Kai Blaschke Date: Mon, 22 Apr 2024 22:54:24 +0200 Subject: [PATCH] New bug report and feature request templates --- .github/ISSUE_TEMPLATE/1-bug_report_user.yml | 106 +++++++++++++ .../ISSUE_TEMPLATE/2-bug_report_developer.yml | 140 ++++++++++++++++++ .github/ISSUE_TEMPLATE/3-feature_request.yml | 72 +++++++++ .github/ISSUE_TEMPLATE/bug_report.md | 25 ---- .github/ISSUE_TEMPLATE/feature_request.md | 20 --- 5 files changed, 318 insertions(+), 45 deletions(-) create mode 100644 .github/ISSUE_TEMPLATE/1-bug_report_user.yml create mode 100644 .github/ISSUE_TEMPLATE/2-bug_report_developer.yml create mode 100644 .github/ISSUE_TEMPLATE/3-feature_request.yml delete mode 100644 .github/ISSUE_TEMPLATE/bug_report.md delete mode 100644 .github/ISSUE_TEMPLATE/feature_request.md diff --git a/.github/ISSUE_TEMPLATE/1-bug_report_user.yml b/.github/ISSUE_TEMPLATE/1-bug_report_user.yml new file mode 100644 index 0000000000..a6bd3a6e44 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/1-bug_report_user.yml @@ -0,0 +1,106 @@ +name: Bug Report (projectM Users) +description: File a report for a use-related issue with projectM, e.g. application crashes, rendering and audio recording problems. +title: "[APP BUG] " +labels: ["triage","bug"] +body: + - type: markdown + attributes: + value: | + You have encountered an issue with a projectM frontend or a plug-in for a third-party application? We're glad to see you reporting that to us! To understand your problem in detail, please fill out this form to the best of your knowledge so we can narrow down and fix it as fast as possible. + + If you want to report an issue regarding projectM _development_, e.g. building any project, integrating it into another project or API issues, please go back and use the developer bug form instead. We ask a few different questions there. + + ### Bugs regarding the projectM Android App + Please note that **we will not accept bug reports for the Android apps** in the Google Play Store. These apps are not being developed by the projectM team. Please report issues directly to the app author via the contact information provided in the Play Store. + - type: checkboxes + id: reporter_ack + attributes: + label: "Please confirm the following points:" + options: + - label: This report is NOT about the Android apps in the Play Store + required: true + - label: I have [searched the project page](https://github.com/search?q=org%3AprojectM-visualizer+type%3Aissue+&type=issues) to check if the issue was already reported + required: true + - type: markdown + attributes: + value: | + Please tell us more about where and with which version you encountered the issue. We will take care about moving the report to the correct repository during triage. + - type: dropdown + id: project + attributes: + label: Affected Application + description: In which application did you encounter an issue? + options: + - I don't know / Other (please elaborate below) + - projectM Standalone SDL2 Frontend (includes the Steam app) + - projectM Standalone Qt Frontend (projectm-pulseaudio) + - Windows Store App + - Apple Music Plug-in for macOS + - Third-Party Integration (Kodi, VLC, etc. - please specify below) + validations: + required: true + - type: input + id: version + attributes: + label: Affected Version + description: Please provide the affected version of the application/plug-in, if you know. You can provide other relevant versions in the description at the end. + placeholder: e.g. 4.1.1 + validations: + required: false + - type: dropdown + id: operating_system + attributes: + label: Operating System + description: If your issue _only_ affects a specific operating system, please select it below. If in doubt, leave it as-is. + options: + - Windows + - macOS + - Linux (Desktop) + - Linux (Embedded, e.g. Raspberry Pi) + - Web Browser + - Other, all or not relevant + default: 5 + validations: + required: true + - type: textarea + id: project_specifics + attributes: + label: Additional Application Details + description: If you have additional information that helps us identify the affected application and version, please tell us here in more detail. You can also upload screenshots with helpful information in this text field. + placeholder: "Describe where you downloaded the application or upload a screenshot of the about dialog" + validations: + required: false + - type: dropdown + id: defect_kind + attributes: + label: Type of Defect + description: Please select which kind of issue you've encountered. + options: + - Crash (unexpected closing, OS crash dialog) + - Graphical issue (rendering glitches, black screen, heavy flickering) + - Low FPS (or continuously high CPU/GPU usage) + - Audio issue (no audio recording, delayed reaction) + - Other + default: 0 + validations: + required: true + - type: textarea + id: log_output + attributes: + label: Log Output + description: Paste any log output here. If a log is very large, e.g. more than 50 lines, please upload it as a file attachment in the description field below. + render: shell + validations: + required: false + - type: markdown + attributes: + value: | + Tip: For the new projectM SDL2 frontend, you can find the log file `projectMSDL.log` at `%APPDATA%\projectM\` on Windows, `~/.config/projectM/` on Linux and `~/Library/Preferences/projectM/` on macOS. + - type: textarea + id: issue_text + attributes: + label: Describe the Issue + description: Please describe the problem in detail. Most importantly, include any information that helps us to reproduce and narrow down the issue. You can also upload additional log files or screenshots. + placeholder: "Steps to reproduce, detailed information about the issue, example presets and other relevant information" + validations: + required: true diff --git a/.github/ISSUE_TEMPLATE/2-bug_report_developer.yml b/.github/ISSUE_TEMPLATE/2-bug_report_developer.yml new file mode 100644 index 0000000000..fe4d2b3f5b --- /dev/null +++ b/.github/ISSUE_TEMPLATE/2-bug_report_developer.yml @@ -0,0 +1,140 @@ +name: Bug Report (Development) +description: File a report for a development-related issue with projectM, e.g. build failures, API/integration issues, bugs or questions regarding projectM's code. +title: "[DEV BUG] " +labels: ["triage","bug"] +body: + - type: markdown + attributes: + value: | + Thanks for taking the time to report an issue with projectM! To understand your problem in detail, please fill out this form, so we can narrow down and help you solve the issue as fast as possible. + + If you want to report an issue encountered while _running a projectM application or plug-in_, e.g. crashes, rendering glitches etc., please go back and use the user bug form instead. We ask a few different questions there. + + ### Bugs regarding the projectM Android App + Please note that **we will not accept bug reports for the Android apps** in the Google Play Store. These apps are not being developed by the projectM team. Please report issues directly to the app author via the contact information provided in the Play Store. + - type: checkboxes + id: reporter_ack + attributes: + label: "Please confirm the following points:" + options: + - label: This report is NOT about the Android apps in the Play Store + required: true + - label: I have [searched the project page](https://github.com/search?q=org%3AprojectM-visualizer+type%3Aissue+&type=issues) to check if the issue was already reported + required: true + - type: markdown + attributes: + value: | + Please tell us more about where and with which version you encountered the issue. This is either the library you want to integrate in your app or the project you're trying to build. + - type: dropdown + id: project + attributes: + label: Affected Project + description: Which project is affected by the issue? + options: + - libprojectM (including the playlist library) + - projectM Expression Evaluation Library + - projectM Standalone SDL2 Frontend (includes the Steam app) + - projectM Standalone Qt Frontend (projectm-pulseaudio) + - Windows Store App + - Apple Music Plug-in for macOS + - Third-Party Integration (Kodi, VLC, etc. - please specify below) + - I don't know / Other (please elaborate below) + validations: + required: true + - type: input + id: version + attributes: + label: Affected Version + description: | + Please provide the affected version, Git tag or specific Git hash of the project in question. + + Add other relevant versions, e.g. of dependencies and build tools, in the "additional details" field below. + placeholder: e.g. 4.1.1 or 3f885d + validations: + required: false + - type: dropdown + id: operating_system + attributes: + label: Operating Systems and Architectures + description: Please select all affected operating systems and architectures below. If in doubt, use the last option. + options: + - Windows (x32) + - Windows (x64) + - Windows (ARM64) + - macOS (x86_64) + - macOS (aarch64) + - Linux (x86) + - Linux (x86_64) + - Linux (aarch64) + - OpenBSD / FreeBSD + - WebAssembly + - All + - Don't know or not relevant + multiple: true + validations: + required: true + - type: dropdown + id: build_tools + attributes: + label: Build Tools + description: Please select the tools you've used when encountering the issue, if appropriate. Please provide additional version information in the text field below. + options: + - "Compiler: Microsoft Windows SDK" + - "Compiler: GNU GCC" + - "Compiler: GNU GCC (MinGW)" + - "Compiler: Clang" + - "Compiler: AppleClang (Xcode)" + - "Build Tool: MSBuild" + - "Build Tool: GNU Make" + - "Build Tool: Ninja Build" + - "Build Tool: CMake" + - "Dependency Manager: vcpkg" + - "Dependency Manager: Homebrew" + - "Dependency Manager: pkgconfig" + multiple: true + validations: + required: false + - type: textarea + id: project_specifics + attributes: + label: Additional Project and Toolset Details + description: Please provide all additional information that helps us to reproduce the issue. This includes specific tool and dependency versions. + placeholder: "Using Visual Studio 2022, Linux distribution and version, building on a Raspberry Pi, ..." + validations: + required: false + - type: dropdown + id: defect_kind + attributes: + label: Type of Defect + description: Please select which kind of issue you want to report. + options: + - Build failure (compiler/linker or toolset error) + - Test failure (existing unit/integration tests fail) + - CMake/CPack issue (configuration, build, install or packaging) + - Specific bug in projectM code (please link the code in question) + - API problem (API function not working or failing unexpectedly) + - Crash (unhandled exceptions, segmentation faults) + - Graphical issue (rendering glitches, no or broken rendering result) + - Low FPS (or continuously high CPU/GPU usage) + - Audio issue (passing audio data not working) + - Missing or outdated documentation + - Other + default: 0 + validations: + required: true + - type: textarea + id: log_output + attributes: + label: Log Output + description: Paste any _relevant_ build/log output here, e.g. compiler errors or debugger output plus required lines for context. If a log is very large (more than 50 lines), please upload it as a file attachment in the description field below. + render: shell + validations: + required: false + - type: textarea + id: issue_text + attributes: + label: Describe the Issue + description: Please describe the problem in detail. Most importantly, include any information that helps us to reproduce and narrow down the issue. You can also upload additional log files or screenshots. + placeholder: "Steps to reproduce, detailed information about the issue, example presets and other relevant information" + validations: + required: true diff --git a/.github/ISSUE_TEMPLATE/3-feature_request.yml b/.github/ISSUE_TEMPLATE/3-feature_request.yml new file mode 100644 index 0000000000..51cefdad60 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/3-feature_request.yml @@ -0,0 +1,72 @@ +name: Feature Request +description: If you're missing an important feature in any projectM app or library, or have a great idea we should implement, use this form. +title: "[FEATURE] " +labels: ["triage","enhancement"] +body: + - type: markdown + attributes: + value: | + ### Feature requests regarding the projectM Android App + Please note that **we cannot change anything in the Android apps** in the Google Play Store. These apps are proprietary/closed-source and not being developed by the projectM team. Please request features directly from the app author via the contact information provided in the Play Store. + - type: checkboxes + id: reporter_ack + attributes: + label: "Please confirm the following points:" + options: + - label: This feature request is NOT for the Android apps in the Play Store + required: true + - label: I have [searched the project page](https://github.com/search?q=org%3AprojectM-visualizer+type%3Aissue+&type=issues) to check if a similar request was already made + required: true + - type: markdown + attributes: + value: | + Please tell us for which application or project you want to suggest a feature. We will take care about moving the request to the correct repository during triage. + - type: dropdown + id: project + attributes: + label: Application or Project + description: For which application or project are you suggesting a new feature or enhancement? + options: + - I don't know / Multiple / Other (please elaborate below) + - projectM Standalone SDL2 Frontend (includes the Steam app) + - projectM Standalone Qt Frontend (projectm-pulseaudio) + - Windows Store App + - Apple Music Plug-in for macOS + - Third-Party Integration (Kodi, VLC, etc. - please specify below) + - libprojectM (including the playlist library) + - projectM Expression Evaluation Library + validations: + required: true + - type: textarea + id: related_problem + attributes: + label: Is Your Enhancement Related to a Problem? + description: If your suggestion is based on a problem you have with an existing application, e.g. frustrating behavior, please describe it here. + placeholder: "Missing hotkeys, strange window behavior, ..." + validations: + required: false + - type: textarea + id: suggested_solution + attributes: + label: Your Suggested Enhancement + description: | + Please tell us what feature, enhancement or solution you have in mind. Describe it as clear and concise as possible. + + The more information you give, the easier it is for us to understand and implement it. + validations: + required: true + - type: textarea + id: alt_solution + attributes: + label: Alternative Solutions + description: If you have any alternative solutions to the above suggestion, e.g. if it's too complex or not technically feasible, please tell us below. + validations: + required: false + - type: textarea + id: additional_context + attributes: + label: Additional Context + description: Any other context you'd like to add, including screenshots of similar features from other applications. + placeholder: "I've seen this in application XY / It works in Milkdrop / Attached a screenshot with an example..." + validations: + required: false diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md deleted file mode 100644 index bf98f22ab0..0000000000 --- a/.github/ISSUE_TEMPLATE/bug_report.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -name: Bug report -about: Create a report to help us improve -title: '' -labels: '' -assignees: '' - ---- - - - - -**Describe the bug** - - -**Screenshots** -If applicable, add screenshots to help explain your problem. - -**Desktop (please complete the following information):** - - Application: [e.g. Steam, SDL, pulseaudio] - - OS: [e.g. macOS, linux, windows] - - Version [e.g. 3.1.12] - -**Additional context** -Add any other context about the problem here. diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md deleted file mode 100644 index bbcbbe7d61..0000000000 --- a/.github/ISSUE_TEMPLATE/feature_request.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -name: Feature request -about: Suggest an idea for this project -title: '' -labels: '' -assignees: '' - ---- - -**Is your feature request related to a problem? Please describe.** -A clear and concise description of what the problem is. Ex. I'm always frustrated when [...] - -**Describe the solution you'd like** -A clear and concise description of what you want to happen. - -**Describe alternatives you've considered** -A clear and concise description of any alternative solutions or features you've considered. - -**Additional context** -Add any other context or screenshots about the feature request here.