From 1b9876cde53da7f817fdb63a6ecf3503dfcfe7ac Mon Sep 17 00:00:00 2001 From: Alvin Schiller <103769832+AlvinSchiller@users.noreply.github.com> Date: Tue, 20 Feb 2024 01:36:36 +0100 Subject: [PATCH] update to Issue Form templates --- .github/ISSUE_TEMPLATE/bug.yaml | 93 +++++++++++++++++++++ .github/ISSUE_TEMPLATE/bug_template.md | 93 --------------------- .github/ISSUE_TEMPLATE/bug_v3.yaml | 94 ++++++++++++++++++++++ .github/ISSUE_TEMPLATE/config.yml | 2 +- .github/ISSUE_TEMPLATE/feature.yaml | 36 +++++++++ .github/ISSUE_TEMPLATE/feature_template.md | 20 ----- .github/ISSUE_TEMPLATE/feature_v3.yaml | 36 +++++++++ .github/ISSUE_TEMPLATE/future3.md | 19 ----- 8 files changed, 260 insertions(+), 133 deletions(-) create mode 100644 .github/ISSUE_TEMPLATE/bug.yaml delete mode 100644 .github/ISSUE_TEMPLATE/bug_template.md create mode 100644 .github/ISSUE_TEMPLATE/bug_v3.yaml create mode 100644 .github/ISSUE_TEMPLATE/feature.yaml delete mode 100644 .github/ISSUE_TEMPLATE/feature_template.md create mode 100644 .github/ISSUE_TEMPLATE/feature_v3.yaml delete mode 100644 .github/ISSUE_TEMPLATE/future3.md diff --git a/.github/ISSUE_TEMPLATE/bug.yaml b/.github/ISSUE_TEMPLATE/bug.yaml new file mode 100644 index 000000000..a25e9797b --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug.yaml @@ -0,0 +1,93 @@ +name: 🐛 Bug Report v2 +description: use this template to report bugs for version 2 +title: "🐛 | " +labels: ["bug", "legacy_v2", "needs triage"] +body: + - type: markdown + attributes: + value: > + Please fill out the form to provide essential information to your problem. + This will help us to faster figure out the root cause. + + - type: input + id: version + attributes: + label: Version + description: | + What version do you use? + See the "info" page in the Web App or the "settings/version" file. + placeholder: e.g. "2.5.0" or "2.6.0-alpha" + validations: + required: true + + - type: input + id: branch + attributes: + label: Branch + description: | + What branch did you install from? + See the "info" page in the Web App or the "settings/version" file. + placeholder: e.g. "master" or "develop" + validations: + required: true + + - type: input + id: os + attributes: + label: OS + description: | + What Operation System and Version do you use? + See `cat /etc/os-release` + placeholder: e.g. "Raspberry Pi OS Bullseye lite - 32bit" + validations: + required: true + + - type: input + id: pi-model + attributes: + label: Pi model + description: | + Which Raspberry Pi model do you use? + placeholder: e.g. "3 B+", "Zero 2" + validations: + required: true + + - type: textarea + id: hardware + attributes: + label: Hardware + description: | + What's your hardware set up? + e.g. Rfid Reader, SoundCards, ... + + - type: textarea + id: what-happened + attributes: + label: What happened? + description: | + What you did, what you expected and what happened instead? + validations: + required: true + + - type: textarea + id: logs + attributes: + label: Logs + description: | + Please provide the logs after the problem occured. + `tail -n 200 /var/log/syslog` (<= Bullseye) or `journalctl -n 200` (>= Bookworm) + render: shell + + - type: textarea + id: config + attributes: + label: Configuration + description: | + Please provide the configuration if its related to the problem + e.g. "mpd.conf", "gpio_settings.ini", ... + + - type: textarea + id: more + attributes: + label: More info + description: Anything more you want to share? diff --git a/.github/ISSUE_TEMPLATE/bug_template.md b/.github/ISSUE_TEMPLATE/bug_template.md deleted file mode 100644 index 222325940..000000000 --- a/.github/ISSUE_TEMPLATE/bug_template.md +++ /dev/null @@ -1,93 +0,0 @@ ---- -name: bug report -about: use this template to report bugs -title: "\U0001F41B | BUG SUMMARY" -labels: bug, needs triage ---- - -## Bug - -### What I did - - - -### What happened - - - -### I expected this to happen - - - -### Further information that might help - - - - -## Software - -### Base image and version - - - -### Branch / Release - - - -### Installscript - - - - -## Hardware - -### RaspberryPi version - - - -### RFID Reader - - - -### Soundcard - - - -### Other notable hardware - - diff --git a/.github/ISSUE_TEMPLATE/bug_v3.yaml b/.github/ISSUE_TEMPLATE/bug_v3.yaml new file mode 100644 index 000000000..5002ff69f --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_v3.yaml @@ -0,0 +1,94 @@ +name: 🐛 Bug Report v3 +description: use this template to report bugs for version 3 +title: "🐛 | " +labels: ["bug", "future3", "needs triage"] +body: + - type: markdown + attributes: + value: > + Please fill out the form to provide essential information to your problem. + This will help us to faster figure out the root cause. + + - type: input + id: version + attributes: + label: Version + description: | + What version do you use? + See the "settings" page in the Web App or the "src/jukebox/jukebox/version.py" file. + placeholder: e.g. "3.5.0" or "3.6.0-alpha" + validations: + required: true + + - type: input + id: branch + attributes: + label: Branch + description: | + What branch did you install from? + See the "settings" page in the Web App or the "src/jukebox/jukebox/version.py" file. + placeholder: e.g. "main" or "develop" + validations: + required: true + + - type: input + id: os + attributes: + label: OS + description: | + What Operation System and Version do you use? + See `cat /etc/os-release` + placeholder: e.g. "Raspberry Pi OS Bullseye lite - 32bit" + validations: + required: true + + - type: input + id: pi-model + attributes: + label: Pi model + description: | + Which Raspberry Pi model do you use? + placeholder: e.g. "3 B+", "Zero 2" + validations: + required: true + + - type: textarea + id: hardware + attributes: + label: Hardware + description: | + What's your hardware set up? + e.g. Rfid Reader, SoundCards, ... + + - type: textarea + id: what-happened + attributes: + label: What happened? + description: | + What you did, what you expected and what happened instead? + validations: + required: true + + - type: textarea + id: logs + attributes: + label: Logs + description: | + Please provide the logs after the problem occured. + `~/RPi-Jukebox-RFID/shared/logs/app.log` -> General Jukebox app logs + `~/RPi-Jukebox-RFID/shared/logs/error.log` -> General Jukebox error logs + `~/INSTALL-XXXXXXXXX.log` -> The logfile being generated when installing the Jukebox code + + - type: textarea + id: config + attributes: + label: Configuration + description: | + Please provide the configuration if its related to the problem + e.g. "mpd.conf", "jukebox.yaml", ... + + - type: textarea + id: more + attributes: + label: More info + description: Anything more you want to share? diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml index e8ce1a65d..e9ad7441d 100644 --- a/.github/ISSUE_TEMPLATE/config.yml +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -4,5 +4,5 @@ contact_links: url: https://github.com/MiczFlor/RPi-Jukebox-RFID/discussions/new?category=q-a about: This issue tracker is not for support questions. Please refer to our Discussions. - name: 💬 Chat - url: https://matrix.to/#/#phoniebox_community:gitter.im + url: https://matrix.to/#/#phoniebox_community:matrix.org about: Want to discuss with others? Check out our chat. diff --git a/.github/ISSUE_TEMPLATE/feature.yaml b/.github/ISSUE_TEMPLATE/feature.yaml new file mode 100644 index 000000000..effee2556 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature.yaml @@ -0,0 +1,36 @@ +name: 🚀 Feature Request v2 +description: use this template to propose feature requests for version 2 +title: "🚀 | " +labels: ["enhancement", "legacy_v2"] +body: + - type: markdown + attributes: + value: > + Please describe your feature request. + + - type: textarea + id: feature + attributes: + label: Feature + description: | + What functionality would you like to see in your phoniebox? + placeholder: | + e.g. `I would love to cook my breakfast eggs with the help of our phoniebox` + + - type: textarea + id: perspective + attributes: + label: User perspective + description: | + How do you envision the feature to work from a users perspective? + placeholder: | + e.g. `In the mornings when I stumble to the bathroom, I want the phoniebox to react on the RFID chip injected under the skin of my right hip. I envision it to walk to the kitchen, get the eggs and a pot out, and start the cooking of the eggs on the stove.` + + - type: textarea + id: further-info + attributes: + label: Further information + description: | + Further information that might help. + placeholder: | + e.g. `The stove is operated with cooking gas, so the implemenation has to make sure the stove is handled with the greatest possible care` diff --git a/.github/ISSUE_TEMPLATE/feature_template.md b/.github/ISSUE_TEMPLATE/feature_template.md deleted file mode 100644 index eb0e22967..000000000 --- a/.github/ISSUE_TEMPLATE/feature_template.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -name: feature request -about: use this template to propose new features -title: "\U0001F680 | FEATURE SUMMARY" -labels: enhancement ---- - -## Feature Description - -### What functionality would you like to see in your phoniebox? - -i.e. `I would love to cook my breakfast eggs with the help of our phoniebox` - -### How do you envision the feature to work from a users perspective? - -i.e. `In the mornings when I stumble to the bathroom, I want the phoniebox to react on the RFID chip injected under the skin of my right hip. I envision it to walk to the kitchen, get the eggs and a pot out, and start the cooking of the eggs on the stove.` - -### Further information that might help - -i.e. `the stove is operated with cooking gas, so the implemenation has to make sure the stove is handled with the greatest possible care` diff --git a/.github/ISSUE_TEMPLATE/feature_v3.yaml b/.github/ISSUE_TEMPLATE/feature_v3.yaml new file mode 100644 index 000000000..eabad30e7 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_v3.yaml @@ -0,0 +1,36 @@ +name: 🚀 Feature Request v3 +description: use this template to propose feature requests for version 3 +title: "🚀 | " +labels: ["enhancement", "future3"] +body: + - type: markdown + attributes: + value: > + Please describe your feature request. + + - type: textarea + id: feature + attributes: + label: Feature + description: | + What functionality would you like to see in your phoniebox? + placeholder: | + e.g. `I would love to cook my breakfast eggs with the help of our phoniebox` + + - type: textarea + id: perspective + attributes: + label: User perspective + description: | + How do you envision the feature to work from a users perspective? + placeholder: | + e.g. `In the mornings when I stumble to the bathroom, I want the phoniebox to react on the RFID chip injected under the skin of my right hip. I envision it to walk to the kitchen, get the eggs and a pot out, and start the cooking of the eggs on the stove.` + + - type: textarea + id: further-info + attributes: + label: Further information + description: | + Further information that might help. + placeholder: | + e.g. `The stove is operated with cooking gas, so the implemenation has to make sure the stove is handled with the greatest possible care` diff --git a/.github/ISSUE_TEMPLATE/future3.md b/.github/ISSUE_TEMPLATE/future3.md deleted file mode 100644 index ab5d6bf00..000000000 --- a/.github/ISSUE_TEMPLATE/future3.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -name: future3 Bug Report -about: Use this template to report bugs for the upcoming version 3 -title: "ISSUE SUMMARY on future3" -labels: future3, bug, needs triage ---- - -### Describe your problem - -Core, Web application ... - -#### What's your hardware set up? - -RPi version, RFID Reader, Audio devices etc. - -#### If possible, try to attach logs from ... (paths from RPi) - - * `~/RPi-Jukebox-RFID/shared/logs` -> General Jukebox logs - * `~/INSTALL-XXXXXXXXX.log` -> The logfile being generated when installing the Jukebox code