From 4c4391e009e3b0d74c315eaca671b69727494d77 Mon Sep 17 00:00:00 2001
From: "Peter F. Patel-Schneider" <pfpschneider@gmail.com>
Date: Sat, 25 Oct 2025 10:20:42 -0400
Subject: [PATCH] doc: update bug report template

---
 .github/ISSUE_TEMPLATE/bug_report.md | 24 ++++++++++++++++--------
 1 file changed, 16 insertions(+), 8 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
index 32385469..5f9b7a8d 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.md
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -8,12 +8,20 @@ assignees: ''
 ---
 
 **Information**
-<!-- Make sure that your issue is not one of the known issues in the Solaar documentation at https://pwr-solaar.github.io/Solaar/ -->
-<!-- Do not bother opening an issue for a version older than 1.1.8.  Upgrade to the latest version and see if your issue persists. -->
-<!-- If you are not running the current version of Solaar, strongly consider upgrading to the newest version. -->
+<!-- Make sure that your issue is not one of the known issues in the
+     Solaar documentation at https://pwr-solaar.github.io/Solaar/ -->
+<!-- Make sure that Solaar's udev rule is running by executing
+     `ls -l /dev/hidraw*` and looking for + as the last character of the permissions. -->
+<!-- Do not bother opening an issue for a version older than 1.1.14.
+     Upgrade to the current version and see if your issue persists. -->
+<!-- If you are not running the current version of Solaar,
+     strongly consider upgrading to the current version. -->
+<!-- Note that some distributions have very old versions of Solaar
+     as their default version.  -->
+
 - Solaar version (`solaar --version` or `git describe --tags` if cloned from this repository):
 - Distribution:
-- Kernel version (ex. `uname -srmo`): `KERNEL VERSION HERE`
+- Kernel version (ex. `uname -srmo`):
 - Output of `solaar show`:
 
 <details>
@@ -34,11 +42,11 @@ CONTENTS HERE
 
 
 - Errors or warrnings from Solaar:
-<!-- Under normal operation Solaar keeps a log of warning and error messages in ~/.tmp
-while it is running as a file starting with 'Solaar'.
+<!-- Under normal operation Solaar keeps a log of warning and error messages
+in ~/.tmp while it is running, as a file starting with 'Solaar'.
 If this file is not available or does not have useful information you can
-run Solaar as `solaar -dd`, after killing any running Solaar processes to
-have Solaar log informational, warning, and error messages to stdout. -->
+run Solaar as `solaar -ddd`, after killing any running Solaar processes to
+have Solaar log debug, informational, warning, and error messages to stdout. -->
 
 
 **Describe the bug**