Re: [PR PATCH] [Updated] .github/ISSUE_TEMPLATE: add bug report and package request issue forms

[classabbyamp <classabbyamp@users.noreply.github.com>]

[-- Attachment #1: Type: text/plain, Size: 2083 bytes --]

There is an updated pull request by classabbyamp against master on the void-packages repository

https://github.com/classabbyamp/void-packages new-issue-templates
https://github.com/void-linux/void-packages/pull/36411

.github/ISSUE_TEMPLATE: add bug report and package request issue forms
Co-authored-by: @0x5c 

This PR replaces the existing markdown-based issue template with two new [Github issue forms](https://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-issue-forms), one for bug reports and one for package requests.

These ensure that the relevant information is asked for and the required information is provided. They also automagically tag issues with the `bug` and `request` tags. If preferred, new bug reports could be also be marked with a second `unconfirmed` or `needs triage` label, applied by the form.

Issues that do not fall under these types (like RFCs) can still be opened by clicking the "open a blank issue" button on the template chooser:
![image](https://user-images.githubusercontent.com/5366828/160756504-21812fa5-c0a0-4c9d-a454-7094fa034ef2.png)
This can be limited to maintainers by changing `blank_issues_enabled` to `false` in `.github/ISSUE_TEMPLATE/config.yml` if desired.

`config.yml` can also be used to add additional arbitrary links in the template chooser. Here's an example [config.yml](https://github.com/miaowware/qrm2/blob/master/.github/ISSUE_TEMPLATE/config.yml) and resulting [template chooser](https://github.com/miaowware/qrm2/issues/new/choose) in another project.

#### Testing the changes
- I tested the changes in this PR: **YES**
    A preview of the rendered templates can be seen [here for the bug report](https://github.com/classabbyamp/void-packages/blob/new-issue-templates/.github/ISSUE_TEMPLATE/bug-report.yml) and [here for the package request](https://github.com/classabbyamp/void-packages/blob/new-issue-templates/.github/ISSUE_TEMPLATE/pkg-request.yml)

A patch file from https://github.com/void-linux/void-packages/pull/36411.patch is attached

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: github-pr-new-issue-templates-36411.patch --]
[-- Type: text/x-diff, Size: 7884 bytes --]

From 17d5c7219c42e11282d6005d65d7e4a30d98fe40 Mon Sep 17 00:00:00 2001
From: classabbyamp <dev@placeviolette.net>
Date: Wed, 30 Mar 2022 00:51:29 -0400
Subject: [PATCH] .github/ISSUE_TEMPLATE: add bug report and package request
 issue forms

Co-authored-by: 0x5c <dev@0x5c.io>
---
 .github/ISSUE_TEMPLATE/bug-report.yml  | 73 ++++++++++++++++++++++
 .github/ISSUE_TEMPLATE/config.yml      |  5 ++
 .github/ISSUE_TEMPLATE/pkg-request.yml | 85 ++++++++++++++++++++++++++
 .github/issue_template.md              | 14 -----
 4 files changed, 163 insertions(+), 14 deletions(-)
 create mode 100644 .github/ISSUE_TEMPLATE/bug-report.yml
 create mode 100644 .github/ISSUE_TEMPLATE/config.yml
 create mode 100644 .github/ISSUE_TEMPLATE/pkg-request.yml
 delete mode 100644 .github/issue_template.md

diff --git a/.github/ISSUE_TEMPLATE/bug-report.yml b/.github/ISSUE_TEMPLATE/bug-report.yml
new file mode 100644
index 000000000000..b8e0dd4eb0fc
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug-report.yml
@@ -0,0 +1,73 @@
+name: Bug Report
+description: File a bug report
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: >
+        #### Don't request an update of a package,
+        [We have a script for that](https://alpha.de.repo.voidlinux.org/void-updates/void-updates.txt).
+        However, a quality pull request may help.
+  - id: xuname
+    type: input
+    attributes:
+      label: System Info
+      description: Output of `xuname` (part of [`xtools`](https://man.voidlinux.org/xtools.1))
+      placeholder: Void 5.x.y_z x86_64-musl ...
+    validations:
+      required: true
+  - id: packages
+    type: input
+    attributes:
+      label: Package(s) Affected
+      description: Affected package(s) including version (this can be found with `xbps-query -p pkgver foo`)
+      placeholder: foo-1.0.2_5, bar-5.6.7_1, baz-0.0.3_5, ...
+    validations:
+      required: true
+  - id: upstream
+    type: textarea
+    attributes:
+      label: Does a report exist for this bug with the project's home (upstream) and/or another distro?
+      description: If so, link it here (It's fine if there's none)
+      placeholder: |
+        For example:
+        https://bugs.kde.org/show_bug.cgi?id=432975
+        https://bugs.gentoo.org/767478
+  - id: expected
+    type: textarea
+    attributes:
+      label: Expected behaviour
+      description: A clear and concise description of what you expected to happen
+      placeholder: The package is supposed to do this thing.
+    validations:
+      required: true
+  - id: description
+    type: textarea
+    attributes:
+      label: Actual behaviour
+      description: A clear and concise description of what the bug is
+      placeholder: There was a crash when...
+    validations:
+      required: true
+  - id: steps
+    type: textarea
+    attributes:
+      label: Steps to reproduce
+      description: Clear steps to reproduce the bug
+      placeholder: |
+        1. Do the thing
+        2. Do the other thing
+        3. ???
+        4. Crash :(
+    validations:
+      required: true
+  - id: verified
+    type: dropdown
+    attributes:
+      label: Is this a new report?
+      description: I verified that there isn't already an open issue for this bug
+      options:
+        - "Yes"
+        - "No"
+    validations:
+      required: true
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
new file mode 100644
index 000000000000..a58023751793
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Other kind of issue
+    url: https://github.com/void-linux/void-packages/issues/new
+    about: For RFCs, tracking issues, etc (freeform text)
diff --git a/.github/ISSUE_TEMPLATE/pkg-request.yml b/.github/ISSUE_TEMPLATE/pkg-request.yml
new file mode 100644
index 000000000000..9b16ae4a93fe
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/pkg-request.yml
@@ -0,0 +1,85 @@
+name: Package Request
+description: Request the addition of a package
+labels: ["request"]
+body:
+  - type: markdown
+    attributes:
+      value: >
+        #### Don't request an update of a package,
+        [We have a script for that](https://alpha.de.repo.voidlinux.org/void-updates/void-updates.txt).
+        However, a quality pull request may help.
+  - id: name
+    type: input
+    attributes:
+      label: Package name
+      placeholder: foobar9k
+    validations:
+      required: true
+  - id: homepage
+    type: input
+    attributes:
+      label: Package homepage
+      placeholder: https://foobar9k.org
+    validations:
+      required: true
+  - id: description
+    type: textarea
+    attributes:
+      label: Description
+      description: What does the package do?
+      placeholder: >
+        Foobar9k is a music player that turns your music up to 11.
+        It provides features X, Y, and Z, which other music players in Void don't.
+    validations:
+      required: true
+  - type: markdown
+    attributes:
+      value: >
+        ## Quality Requirements
+
+        To be included in the Void repository, software must meet **at least one** of the following requirements.
+        Exceptions to the list are possible, and might be accepted, but are extremely unlikely.
+        If you believe you have an exception, make an argument for why that particular piece of software,
+        while not meeting any of the following requirements, is a good candidate for inclusion in void-packages.
+
+
+        In particular, new themes are highly unlikely to be accepted.
+        Simple shell scripts are unlikely to be accepted unless they provide considerable value to a broad user base.
+        New fonts may be accepted if they provide value beyond aesthetics
+        (e.g. they contain glyphs for a script missing in already packaged fonts).
+
+
+        Browser forks, including those based on Chromium and Firefox, are generally not accepted.
+        Such forks require heavy patching, maintenance and hours of build time.
+  - id: quality
+    type: dropdown
+    attributes:
+      label: Does the requested package meet the quality requirements?
+      description: |
+        **System:** The software should be installed system-wide, not per-user
+        **Compiled:** The software needs to be compiled before being used, even if it is software that is not needed by the whole system
+        **Required:** Another package either within the repository or pending inclusion requires the package
+      multiple: true
+      options:
+        - System
+        - Compiled
+        - Required
+    validations:
+      required: true
+  - type: markdown
+    attributes:
+      value: >
+        ## Release Status
+
+        Software need to be used in version announced by authors as ready to use by the general public - usually called releases.
+        Betas, pre-releases, and arbitrary VCS revisions won't be accepted.
+  - id: released
+    type: dropdown
+    attributes:
+      label: Is the requested package released?
+      description: "The software is available in a version announced by authors as ready-to-use by the general public"
+      options:
+        - "Yes"
+        - "No"
+    validations:
+      required: true
diff --git a/.github/issue_template.md b/.github/issue_template.md
deleted file mode 100644
index 25a0538174cc..000000000000
--- a/.github/issue_template.md
+++ /dev/null
@@ -1,14 +0,0 @@
-<!-- Don't request update of package. We have a script for that. https://alpha.de.repo.voidlinux.org/void-updates/void-updates.txt . However, a quality pull request may help. -->
-### System
-
-* xuname:  
-  *output of ``xuname`` (part of xtools)*
-* package:  
-  *affected package(s) including the version*: ``xbps-query -p pkgver <pkgname>``
-
-### Expected behavior
-
-### Actual behavior
-
-### Steps to reproduce the behavior
-