From 25ddcbf683fb5a7e0b1c9760a0f93ed980f78b51 Mon Sep 17 00:00:00 2001
From: "Unknown W. Brackets" <checkins@unknownbrackets.org>
Date: Sun, 14 Mar 2021 10:12:29 -0700
Subject: [PATCH] GitHub: Add multiple issue templates w/checklists.

To ask better questions upfront.
---
 .github/ISSUE_TEMPLATE                | 14 ---------
 .github/ISSUE_TEMPLATE/bug.md         | 34 +++++++++++++++++++++
 .github/ISSUE_TEMPLATE/build.md       | 28 +++++++++++++++++
 .github/ISSUE_TEMPLATE/config.yml     | 11 +++++++
 .github/ISSUE_TEMPLATE/feature.md     | 30 +++++++++++++++++++
 .github/ISSUE_TEMPLATE/graphics.md    | 43 +++++++++++++++++++++++++++
 .github/ISSUE_TEMPLATE/performance.md | 42 ++++++++++++++++++++++++++
 .github/issue_template.md             | 29 ++++++++++++++++++
 8 files changed, 217 insertions(+), 14 deletions(-)
 delete mode 100644 .github/ISSUE_TEMPLATE
 create mode 100644 .github/ISSUE_TEMPLATE/bug.md
 create mode 100644 .github/ISSUE_TEMPLATE/build.md
 create mode 100644 .github/ISSUE_TEMPLATE/config.yml
 create mode 100644 .github/ISSUE_TEMPLATE/feature.md
 create mode 100644 .github/ISSUE_TEMPLATE/graphics.md
 create mode 100644 .github/ISSUE_TEMPLATE/performance.md
 create mode 100644 .github/issue_template.md

diff --git a/.github/ISSUE_TEMPLATE b/.github/ISSUE_TEMPLATE
deleted file mode 100644
index a3083633a5..0000000000
--- a/.github/ISSUE_TEMPLATE
+++ /dev/null
@@ -1,14 +0,0 @@
-<!-- Want the issue fixed faster?  Check the wiki for tips:
-https://github.com/hrydgard/ppsspp/wiki/How-to-report-an-issue-properly
-You can remove this stuff - just don't forget to answer the questions.  They're important. -->
-
-
-### What happens?
-
-
-### What *should* happen?
-
-
-### What hardware, operating system, and PPSSPP version?  On desktop and mobile phone, GPU matters for graphical issues.
-### Please test newest version in https://buildbot.orphis.net/ppsspp/
-
diff --git a/.github/ISSUE_TEMPLATE/bug.md b/.github/ISSUE_TEMPLATE/bug.md
new file mode 100644
index 0000000000..837cb61c75
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug.md
@@ -0,0 +1,34 @@
+---
+name: Bug, crash, or compatibility issue
+about: Choose this if something doesn't work and no other template applies.
+labels: needs triage
+---
+<!-- Want the issue fixed faster?  Check the wiki for tips:
+https://github.com/hrydgard/ppsspp/wiki/How-to-report-an-issue-properly
+You can remove this stuff - just don't forget to answer the questions.
+They're important. -->
+
+
+### What happens?
+
+
+### What *should* happen?
+
+
+### What are you using?
+#### What hardware / device and operating system?
+
+#### What graphics card (GPU) or mobile phone model?
+
+#### What PPSSPP version (standalone/official), and did it work before?
+
+#### Which game or games?
+<!-- Long press on the game in PPSSPP to include the game ID. -->
+
+
+#### Checklist
+<!-- Don't forget the below, change [ ] to [X] when done.  Note anything else you tried. -->
+ - [ ] Test in the [latest git build](https://buildbot.orphis.net/ppsspp/) in case it's already fixed.
+ - [ ] [Search for other reports](https://github.com/hrydgard/ppsspp/search?q=my+issue&type=issues) of the same issue.
+ - [ ] Try resetting settings or older versions and include if the issue is related.
+ - [ ] Include logs or screenshots of issue.
diff --git a/.github/ISSUE_TEMPLATE/build.md b/.github/ISSUE_TEMPLATE/build.md
new file mode 100644
index 0000000000..6c565b95d6
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/build.md
@@ -0,0 +1,28 @@
+---
+name: Building or contributing
+about: Choose for issues building PPSSPP on certain platforms or with certain toolsets.
+labels: needs triage
+---
+<!-- You can remove this stuff - just don't forget to answer the questions.
+They're important. -->
+
+### What platform, compiler, and build tools?
+
+
+### What happens (don't forget logs)?
+
+
+### What are you using?
+#### What hardware / device and operating system?
+
+#### What PPSSPP version (standalone/official), and did it work before?
+
+
+#### Checklist
+<!-- Don't forget the below, change [ ] to [X] when done.  Note anything else you tried. -->
+ - [ ] Test in the [latest git build](https://buildbot.orphis.net/ppsspp/) in case it's already fixed.
+ - [ ] Don't forget `git submodule update --init --recursive`.
+ - [ ] [Search for other reports](https://github.com/hrydgard/ppsspp/search?q=my+issue&type=issues) of the same issue.
+ - [ ] Try deleting the build directory and starting fresh.
+ - [ ] Include logs and help us reproduce.
+ - [ ] Check GitHub Actions, which builds every merge and PR.
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
new file mode 100644
index 0000000000..6f478bb9da
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,11 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Forums for questions and help
+    url: https://forums.ppsspp.org/
+    about: 'Please ask questions here or on Discord.  Includes multiplayer resources, texture packs, cheats, and performance tips.'
+  - name: Compatibility list
+    url: http://report.ppsspp.org/games
+    about: Look here for user reports on best settings and compatibility.
+  - name: Translations
+    url: https://github.com/hrydgard/ppsspp-lang
+    about: Look here to contribute translations to PPSSPP.
diff --git a/.github/ISSUE_TEMPLATE/feature.md b/.github/ISSUE_TEMPLATE/feature.md
new file mode 100644
index 0000000000..6a82a5f328
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature.md
@@ -0,0 +1,30 @@
+---
+name: New feature or behavior change
+about: Choose when something isn't broken, but you want it to be better.
+labels: needs triage
+---
+<!-- Want the improvement faster?  Check the wiki for tips:
+https://github.com/hrydgard/ppsspp/wiki/How-to-report-an-issue-properly
+You can remove this stuff - just don't forget to answer the questions.
+They're important. -->
+
+
+### What should happen?
+
+
+### Who would benefit from it?
+
+
+### What's it specific to (remove if not)?
+#### Hardware, device, or operating system?
+
+#### Specific games?
+<!-- Requests for mods to game logic belong in the forum or Discord. -->
+
+### Does anything else have a similar feature?
+
+
+#### Checklist
+<!-- Don't forget the below, change [ ] to [X] when done.  Note anything else you tried. -->
+ - [ ] Check the [latest git build](https://buildbot.orphis.net/ppsspp/) in case it's already implemented.
+ - [ ] [Search for other requests](https://github.com/hrydgard/ppsspp/search?q=my+issue&type=issues) of the same feature.
diff --git a/.github/ISSUE_TEMPLATE/graphics.md b/.github/ISSUE_TEMPLATE/graphics.md
new file mode 100644
index 0000000000..9de08270e0
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/graphics.md
@@ -0,0 +1,43 @@
+---
+name: Graphics or rendering issue
+about: Choose when something is drawing wrong.
+labels: needs triage
+---
+<!-- Want the issue fixed faster?  Check the wiki for tips:
+https://github.com/hrydgard/ppsspp/wiki/How-to-report-an-issue-properly
+You can remove this stuff - just don't forget to answer the questions.
+They're important. -->
+
+
+### What happens?
+<!-- Include screenshots and explain why they're wrong. -->
+
+
+### What *should* happen?
+
+
+### Include a GE frame capture
+<!-- See: https://github.com/hrydgard/ppsspp/wiki/How-to-create-a-frame-dump
+Make sure the issue is visible when you take it. -->
+
+
+### What are you using?
+#### What hardware / device and operating system?
+
+#### What graphics card (GPU) or mobile phone model?
+
+#### What PPSSPP version (standalone/official), and did it work before?
+
+#### Which game or games?
+<!-- Long press on the game in PPSSPP to include the game ID. -->
+
+#### Graphics backend (Vulkan, OpenGL, etc.)?
+
+
+#### Checklist
+<!-- Don't forget the below, change [ ] to [X] when done.  Note anything else you tried. -->
+ - [ ] Test in the [latest git build](https://buildbot.orphis.net/ppsspp/) in case it's already fixed.
+ - [ ] [Search for other reports](https://github.com/hrydgard/ppsspp/search?q=my+issue&type=issues) of the same issue.
+ - [ ] Try resetting settings or older versions and include if the issue is related.
+ - [ ] Try changing graphics settings to determine if one causes the bug.
+ - [ ] Include logs or screenshots of issue.
diff --git a/.github/ISSUE_TEMPLATE/performance.md b/.github/ISSUE_TEMPLATE/performance.md
new file mode 100644
index 0000000000..569e37c68a
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/performance.md
@@ -0,0 +1,42 @@
+---
+name: Slowdown or performance problem
+about: Choose when things got slower from a previous version or a specific scene runs really poorly.
+labels: needs triage
+---
+<!-- Want the issue fixed faster?  Check the wiki for tips:
+https://github.com/hrydgard/ppsspp/wiki/How-to-report-an-issue-properly
+You can remove this stuff - just don't forget to answer the questions.
+They're important. -->
+
+
+### What games and where in them does it happen?
+<!-- Long press on the game in PPSSPP to include the game ID. -->
+
+
+### What speed are you getting with PPSSPP speed display enabled?
+
+
+### Include a GE frame capture and debug stats
+<!-- See: https://github.com/hrydgard/ppsspp/wiki/How-to-create-a-frame-dump
+Many performance issues are graphics related.
+
+Also enable "Show debug statistics" and include a screenshot while it's on. -->
+
+
+### What are you using?
+#### What hardware / device and operating system?
+
+#### What graphics card (GPU) or mobile phone model?
+
+#### What PPSSPP version (standalone/official), and did it work before?
+
+#### Graphics backend (Vulkan, OpenGL, etc.)?
+
+
+#### Checklist
+<!-- Don't forget the below, change [ ] to [X] when done.  Note anything else you tried. -->
+ - [ ] Test in the [latest git build](https://buildbot.orphis.net/ppsspp/) in case it's already fixed.
+ - [ ] [Search for other reports](https://github.com/hrydgard/ppsspp/search?q=my+issue&type=issues) of the same issue.
+ - [ ] Try resetting settings or older versions and include if the issue is related.
+ - [ ] Try changing graphics settings to determine if one causes the slowdown.
+ - [ ] Include logs of screenshots of issue.
diff --git a/.github/issue_template.md b/.github/issue_template.md
new file mode 100644
index 0000000000..d8eb6547cc
--- /dev/null
+++ b/.github/issue_template.md
@@ -0,0 +1,29 @@
+<!-- Want the issue fixed faster?  Check the wiki for tips:
+https://github.com/hrydgard/ppsspp/wiki/How-to-report-an-issue-properly
+You can remove this stuff - just don't forget to answer the questions.
+They're important. -->
+
+
+### What happens?
+
+
+### What *should* happen?
+
+
+### What are you using?
+#### What hardware / device and operating system?
+
+#### What graphics card (GPU) or mobile phone model?
+
+#### What PPSSPP version (standalone/official), and did it work before?
+
+#### Which game or games?
+<!-- Long press on the game in PPSSPP to include the game ID. -->
+
+
+#### Checklist
+<!-- Don't forget the below, change [ ] to [X] when done.  Note anything else you tried. -->
+ - [ ] Test in the [latest git build](https://buildbot.orphis.net/ppsspp/) in case it's already fixed.
+ - [ ] [Search for other reports](https://github.com/hrydgard/ppsspp/search?q=my+issue&type=issues) of the same issue.
+ - [ ] Try resetting settings or older versions and include if the issue is related.
+ - [ ] Include logs or screenshots of issue.