From 0b21c93324f587bef7d2ca5d1c7aaca7bb266a44 Mon Sep 17 00:00:00 2001
From: sfan5 <sfan5@live.de>
Date: Fri, 8 Aug 2025 12:34:14 +0200
Subject: [PATCH] Update issue template

---
 .github/ISSUE_TEMPLATE/bug_report.yaml | 36 +++++++++++++++++---------
 1 file changed, 24 insertions(+), 12 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/bug_report.yaml b/.github/ISSUE_TEMPLATE/bug_report.yaml
index 29df88d18..e684b08aa 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.yaml
+++ b/.github/ISSUE_TEMPLATE/bug_report.yaml
@@ -1,5 +1,5 @@
 name: Bug report
-description: Create a report to help us improve
+description: Report a problem or mistake
 labels: ["Unconfirmed bug"]
 body:
   - type: markdown
@@ -7,16 +7,16 @@ body:
       value: |
         Please note the following:
 
-        1. **Please update Luanti to the latest stable or dev version** before submitting bug reports. Make sure the bug is still reproducible on the latest version.
-        2. This page is for reporting the bugs of **the engine itself**. For bugs in a particular game, please [search for the game in the ContentDB](https://content.luanti.org/packages/?type=game) and submit a bug report in their issue trackers.
-            * For example, you can submit issues about the Minetest Game [in its own repository](https://github.com/luanti-org/minetest_game/issues).
-        3. Please provide as many details as possible for us to spot the problem quicker.
+        1. **Update Luanti to the latest stable or dev version** before submitting a bug report. Make sure the bug is still reproducible on the latest version.
+        2. This page is for reporting the bugs of **the engine itself**. For bugs in a particular game, please [search for the game on ContentDB](https://content.luanti.org/packages/?type=game) and submit a bug report to its developers.
+            * For example, issues about Minetest Game are submitted to [its own repository](https://github.com/luanti-org/minetest_game/issues).
+        3. Please provide as many relevant details as possible.
+
   - type: textarea
     attributes:
       label: Luanti version
       description: |
         Paste the Luanti version below.
-        If you are on a dev version, please also indicate the git commit hash.
         Refer to the "About" tab of the menu or run `luanti --version` on the command line.
       placeholder: |
         Example:
@@ -34,27 +34,28 @@ body:
       render: "true"
     validations:
       required: true
+
   - type: input
     attributes:
       label: Operating system and version
-      description: It is recommended to upgrade your operating system to see if the problem persists.
+      description: Keeping your OS up-to-date can solve some problems on its own.
       placeholder: "Example: Ubuntu 22.04"
     validations:
       required: true
   - type: input
     attributes:
       label: CPU model
-      description: Usually found in OS/system settings.
+      description: Usually found in OS/system settings
       placeholder: "Example: Intel Core i5-2410M"
     validations:
       required: false
   - type: markdown
     attributes:
-      value: The GPU model and renderer can be omitted if the bug is not a graphical issue.
+      value: If the bug is server-side please skip the "GPU model" and "Active renderer" fields.
   - type: input
     attributes:
       label: GPU model
-      description: Usually found in OS/system settings.
+      description: Usually found in OS/system settings
       placeholder: "Example: NVIDIA GeForce GTX 1660"
     validations:
       required: false
@@ -65,15 +66,26 @@ body:
       placeholder: "Example: ES 3.2 / ogles2 / X11"
     validations:
       required: false
+
   - type: textarea
     attributes:
       label: Summary
-      description: Describe your problem here.
+      description: |
+        Describe your problem here.
+
+        Make sure to include the all error messages you see and/or screenshots in case of visual bugs.
+        Attaching a copy of your `debug.txt` and `minetest.conf` can be helpful as well.
     validations:
       required: true
   - type: textarea
     attributes:
       label: Steps to reproduce
-      description: Explain how the problem has happened, providing a minimal test (e.g. a minimized code snippet) where possible.
+      description: |
+        Explain how the problem has happened.
+
+        To the extent possible, the reproduction steps should describe not just what you did (e.g. "I open my world and it crashes")
+        but be detailed enough so that anyone with a fresh installation of Luanti could follow these steps to encounter the same problem.
+        In case of modding issues it is often useful to include a code snippet.
+        This will help us diagnose the problem quicker and more efficiently. Thank you.
     validations:
       required: true