Pull request 1926: imp-gh-tmpls

Squashed commit of the following:

commit 1a66a8af6aeb1b57507759b526d5adca2e8f7d1d
Author: Ainar Garipov <A.Garipov@AdGuard.COM>
Date:   Mon Jul 17 17:09:45 2023 +0300

    .github: fix length

commit b9551cd5b09531cdb7887bd657a60459dd59259c
Author: Ainar Garipov <A.Garipov@AdGuard.COM>
Date:   Mon Jul 17 16:58:48 2023 +0300

    all: imp gh tmpls, readme

.github/ISSUE_TEMPLATE/bug.yml

@@ -32,31 +32,33 @@
   - 'attributes':
         'description': 'On which Platform does the issue occur?'
         'label': 'Platform (OS and CPU architecture)'
+        # NOTE: Keep the 386 at the bottom for each OS, because a lot of people
+        # Seem to confuse them with AMD64, which is what they actually need.
         'options':
-          - 'Darwin (aka macOS)/AMD64 (aka x86_64)'
+          - 'Darwin (aka macOS), AMD64 (aka x86_64)'
-          - 'Darwin (aka macOS)/ARM64'
+          - 'Darwin (aka macOS), ARM64'
-          - 'FreeBSD/386'
+          - 'FreeBSD, AMD64 (aka x86_64)'
-          - 'FreeBSD/AMD64 (aka x86_64)'
+          - 'FreeBSD, ARM64'
-          - 'FreeBSD/ARM64'
+          - 'FreeBSD, ARMv5'
-          - 'FreeBSD/ARMv5'
+          - 'FreeBSD, ARMv6'
-          - 'FreeBSD/ARMv6'
+          - 'FreeBSD, ARMv7'
-          - 'FreeBSD/ARMv7'
+          - 'FreeBSD, 32-bit Intel (aka 386)'
-          - 'Linux/386'
+          - 'Linux, AMD64 (aka x86_64)'
-          - 'Linux/AMD64 (aka x86_64)'
+          - 'Linux, ARM64'
-          - 'Linux/ARM64'
+          - 'Linux, ARMv5'
-          - 'Linux/ARMv5'
+          - 'Linux, ARMv6'
-          - 'Linux/ARMv6'
+          - 'Linux, ARMv7'
-          - 'Linux/ARMv7'
+          - 'Linux, MIPS LE'
-          - 'Linux/MIPS LE'
+          - 'Linux, MIPS'
-          - 'Linux/MIPS'
+          - 'Linux, MIPS64 LE'
-          - 'Linux/MIPS64 LE'
+          - 'Linux, MIPS64'
-          - 'Linux/MIPS64'
+          - 'Linux, PPC64 LE'
-          - 'Linux/PPC64 LE'
+          - 'Linux, 32-bit Intel (aka 386)'
-          - 'OpenBSD/AMD64 (aka x86_64)'
+          - 'OpenBSD, AMD64 (aka x86_64)'
-          - 'OpenBSD/ARM64'
+          - 'OpenBSD, ARM64'
-          - 'Windows/386'
+          - 'Windows, AMD64 (aka x86_64)'
-          - 'Windows/AMD64 (aka x86_64)'
+          - 'Windows, ARM64'
-          - 'Windows/ARM64'
+          - 'Windows, 32-bit Intel (aka 386)'
           - 'Custom (please mention in the description)'
     'id': 'os'
     'type': 'dropdown'
@@ -142,8 +144,10 @@
     'type': 'textarea'
     'validations':
         'required': false
-'description': >
+# NOTE: GitHub limits the description length to 200 characters.
-    Open a bug report.  Please do not open bug reports for questions or help
+'description': |
-    with configuring clients.  If you want to ask for help, use the Discussions
+    For help, use the **Discussions** section instead.
-    section.
+
+    Write the **title in English** to make it easier for other people to search
+    for duplicates.  (Any language is fine in the body.)
 'name': 'Bug'

.github/ISSUE_TEMPLATE/feature.yml

@@ -48,7 +48,10 @@
     'type': 'textarea'
     'validations':
         'required': false
-'description': 'Suggest a feature or an enhancement for AdGuard Home'
+# NOTE: GitHub limits the description length to 200 characters.
+'description': >
+    Write the **title in English** to make it easier for other people to search
+    for duplicates.  (Any language is fine in the body.)
 'labels':
   - 'feature request'
 'name': 'Feature request or enhancement'

README.md

@@ -416,7 +416,8 @@ There are three options how you can install an unstable version:
    ###  <a href="#reporting-issues" id="reporting-issues" name="reporting-issues">Report issues</a>
 
 If you run into any problem or have a suggestion, head to [this page][iss] and
-click on the “New issue” button.
+click on the “New issue” button.  Please follow the instructions in the issue
+form carefully and don't forget to start by searching for duplicates.
 
 [iss]: https://github.com/AdguardTeam/AdGuardHome/issues