Merge pull request #4372 from nextcloud/feature/issue-templates

Add a new yml github issue template for bug reports.

2 files changed, 172 insertions, 86 deletions

diff --git a/.github/ISSUE_TEMPLATE/BUG_REPORT.yml b/.github/ISSUE_TEMPLATE/BUG_REPORT.yml
new file mode 100644
index 000000000..935ae8723
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/BUG_REPORT.yml
@@ -0,0 +1,172 @@
+name: "Bug report: Nextcloud Desktop Client"
+description: "Submit a report and help us improve the Nextcloud Desktop Client"
+title: "[Bug]: "
+labels: ["0. Needs triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ### 👍 Thank you for contributing to our project!
+        * This is the **issue tracker of Nextcloud**, please do NOT use this to get answers to your questions or get help for fixing your installation. You can find help debugging your system on our home user forums: https://help.nextcloud.com or, if you use Nextcloud in a large organization, ask our engineers on https://portal.nextcloud.com. See also  https://nextcloud.com/support for support options.
+        * Please search the existing issues first, it's likely that your issue was already reported or even fixed.
+            - Go to https://github.com/nextcloud and type any word in the top search/command bar. You probably see something like "We couldn’t find any repositories matching ..." then click "Issues" in the left navigation.
+            - You can also filter by appending e. g. "state:open" to the search string.
+            - More info on search syntax within github: https://help.github.com/articles/searching-issues
+  - type: checkboxes
+    id: before-posting
+    attributes:
+      label: "⚠️ Before submitting, please verify the following: ⚠️"
+      description: All conditions are **required**. Your issue can be closed if these are checked incorrectly.
+      options:
+        - label: This is a **bug**, not a question or a configuration issue.
+          required: true
+        - label: This issue is **not** already reported on Github (I've searched it).
+          required: true
+        - label: Nextcloud Server and Desktop Client are **up to date**. See [Server Maintenance and Release Schedule](https://github.com/nextcloud/server/wiki/Maintenance-and-Release-Schedule) and [Desktop Releases](https://nextcloud.com/install/#install-clients) for supported versions.
+          required: true
+        - label: I agree to follow Nextcloud's [Code of Conduct](https://nextcloud.com/contribute/code-of-conduct/)
+          required: true
+  - type: textarea
+    id: bug-description
+    attributes:
+      label: Bug description
+      description: Provide a description of the bug you're experiencing.
+      value: |
+        The share dialog is looking incomplete.
+        ...
+    validations:
+      required: true
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Steps to reproduce
+      description: Describe the steps to reproduce the bug.
+      value: |
+        1. Right click on the file
+        2. Click on Share Options
+        3. The share dialog does not display the option to share by e-mail
+        ...
+    validations:
+      required: true
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: Expected behavior
+      description: Describe what you expected to happen.
+      value: |
+        When clicking on the share dialog, share by e-mail should be an option.
+        ...
+    validations:
+      required: true
+  - type: input
+    id: files
+    attributes:
+      label: Which files are affected by this bug
+      description: Please, list **at least one file** that is affected by the issue reported. It will be easier to check the logs for errors.
+    validations:
+      required: true
+  - type: dropdown
+    id: system
+    attributes:
+      label: Operating system
+      description: In which operating system you are running the desktop client.
+      options:
+        - "Windows"
+        - "Mac OS"
+        - "Linux"
+    validations:
+      required: true
+  - type: input
+    id: distro
+    attributes:
+      label: Which version of the operating system you are running.
+      description: In case of Linux, provide the distribution.
+      placeholder: Windows 10
+    validations:
+      required: true
+  - type: dropdown
+    id: install-method
+    attributes:
+      label: Package
+      description: Select installation method you used.
+      options:
+        - "Appimage"
+        - "Official SNAP package"
+        - "Compiled it myself"
+        - "Distro package manager"
+        - "Other"
+    validations:
+      required: true
+  - type: input
+    id: server-version
+    attributes:
+      label: Nextcloud Server version
+      description: Nextcloud Server version.
+      placeholder: 23.0.1
+    validations:
+      required: true
+  - type: dropdown
+    id: fresh
+    attributes:
+      label: Is this bug present after an update or on a fresh install?
+      description: Select if bug is present after an update or on a fresh install.
+      options:
+        - "Updated from a minor version (ex. 3.4.2 to 3.4.4)"
+        - "Updated to a major version (ex. 3.3.6 to 3.4.0)"
+        - "Fresh desktop client install"
+    validations:
+      required: true
+  - type: dropdown
+    id: encryption
+    attributes:
+      label: Are you using the Nextcloud Server Encryption module?
+      description: |
+        Select if encryption is Enabled on your Nextcloud Server.
+      options:
+        - "Encryption is Enabled"
+        - "Encryption is Disabled"
+    validations:
+      required: true
+  - type: checkboxes
+    id: users
+    attributes:
+      label: Are you using an external user-backend?
+      description: |
+        Select all user-backends Enabled on your Nextcloud Server.
+        Describe in the "Additional info" section if you chose "Other".
+      options:
+      - label: "Default internal user-backend"
+      - label: "LDAP/ Active Directory"
+      - label: "SSO - SAML"
+      - label: "Other"
+    validations:
+      required: true
+  - type: textarea
+    id: desktop-logs
+    attributes:
+      label: Nextcloud Server logs
+      description: |
+        Provide Nextcloud Server logs lines.
+        Copy all contents from `data/nextcloud.log` or a RAW from `/settings/admin/logging` section:
+        > NOTE: This will be automatically formatted into code or attach the file to the issue.
+      render: shell
+    validations:
+      required: false
+  - type: textarea
+    id: additional-info
+    attributes:
+      label: Additional info
+      description: Any additional information related to the issue.
+    validations:
+      required: false
+  - type: markdown
+    attributes:
+      value: |
+        ## :warning: Desktop Client Logs
+        Since 3.1: Under the "General" settings, you can click on **"Create Debug Archive"** to pick the location of where the desktop client will export the logs and the database to a zip file: https://docs.nextcloud.com/desktop/3.4/troubleshooting.html#create-debug-archive
+        > Please attach the debug archive to this issue.
+  - type: markdown
+    attributes:
+      value: |
+        ## :camera: Screenshots
+        Feel free to attach any screenshots that might help you to describe the bug your are experiencing.
diff --git a/.github/ISSUE_TEMPLATE/bug.md b/.github/ISSUE_TEMPLATE/bug.md
deleted file mode 100644
index e9a401a83..000000000
--- a/.github/ISSUE_TEMPLATE/bug.md
+++ /dev/null
@@ -1,86 +0,0 @@
----
-name: Bugs
-about: Crashes and other bugs
-labels: 'bug'
-
----
-
-<!--
-Thanks for reporting issues back to Nextcloud!
-
-This is the **issue tracker of Nextcloud**, please do NOT use this to get answers to your questions or get help for fixing your installation. You can find help debugging your system on our home user forums: https://help.nextcloud.com or, if you use Nextcloud in a large organization, ask our engineers on https://portal.nextcloud.com. See also  https://nextcloud.com/support for support options.
-
-Guidelines for submitting issues:
-
-* Please search the existing issues first, it's likely that your issue was already reported or even fixed.
-    - Go to https://github.com/nextcloud and type any word in the top search/command bar. You probably see something like "We couldn’t find any repositories matching ..." then click "Issues" in the left navigation.
-    - You can also filter by appending e. g. "state:open" to the search string.
-    - More info on search syntax within github: https://help.github.com/articles/searching-issues
-    
-* Please fill in as much of the template below as possible. The logs are absolutely crucial for the developers to be able to help you. Expect us to quickly close issues without logs or other information we need. 
-
-* Also note that we have a https://nextcloud.com/contribute/code-of-conduct/ that applies on Github. To summarize it: be kind. We try our best to be nice, too. If you can't be bothered to be polite, please just don't bother to report issues as we won't feel motivated to help you. 
--->
-
-<!--- Please keep the note below for others who read your bug report -->
-
-### How to use GitHub
-
-* Please use the 👍 [reaction](https://blog.github.com/2016-03-10-add-reactions-to-pull-requests-issues-and-comments/) to show that you are affected by the same issue.
-* Please don't comment if you have no relevant information to add. It's just extra noise for everyone subscribed to this issue.
-* Subscribe to receive notifications on status change and new comments. 
-
-
-### Expected behaviour
-Tell us what should happen
-
-### Actual behaviour
-Tell us what happens instead
-
-
-### Steps to reproduce
-1.
-2.
-3.
-
-### Client configuration
-Client version:
-<!---
-Please try to only report a bug if it happens with the latest version
-The latest version can be seen by checking https://nextcloud.com/install/#install-clients
---->
-
-Operating system:
-
-OS language:
-
-Qt version used by client package (Linux only, see also Settings dialog):
-
-Client package (From Nextcloud or distro) (Linux only):
-
-Installation path of client:
-
-
-### Server configuration
-<!---
-Optional section. It depends on the issue.
---->
-Nextcloud version:
-
-Storage backend (external storage):
-
-### Logs
-<!-- desktop client logs are a hard requirement for bug reports because we don't know how to do magic here :) -->
-
-Please use Gist (https://gist.github.com/) or a similar code paster for longer
-logs.
-
-1. Client logfile: 
-Since 3.1: Under the "General" settings, you can click on "Create Debug Archive ..." to pick the location of where the desktop client will export the logs and the database to a zip file.
-On previous releases: Via the command line: `nextcloud --logdebug --logwindow` or `nextcloud --logdebug --logfile log.txt`
-(See also https://docs.nextcloud.com/desktop/3.0/troubleshooting.html#log-files)
-
-2. Web server error log:
-
-3. Server logfile: nextcloud log (data/nextcloud.log):
-