From 6d138ae8fa5e5e23240f3cb3ef37f1322b13cfdd Mon Sep 17 00:00:00 2001
From: Thanatomanic <6567747+Thanatomanic@users.noreply.github.com>
Date: Thu, 21 Jan 2021 21:20:06 +0100
Subject: [PATCH 1/2] Update issue templates

In an attempt to enhance/professionalize our issue tracker, I've worked on some templates for issue submission. Please provide feedback.
---
 .github/ISSUE_TEMPLATE/bug_report.md          | 40 +++++++++++++++++++
 .../camera-support---color-calibration.md     | 13 ++++++
 .github/ISSUE_TEMPLATE/camera-support.md      | 10 +++++
 .../feature-request---enhancements.md         | 15 +++++++
 4 files changed, 78 insertions(+)
 create mode 100644 .github/ISSUE_TEMPLATE/bug_report.md
 create mode 100644 .github/ISSUE_TEMPLATE/camera-support---color-calibration.md
 create mode 100644 .github/ISSUE_TEMPLATE/camera-support.md
 create mode 100644 .github/ISSUE_TEMPLATE/feature-request---enhancements.md

diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
new file mode 100644
index 000000000..d6d418f42
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -0,0 +1,40 @@
+---
+name: Bug report
+about: Is something not working as it should? Please report it here.
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+<!-- READ THIS FIRST
+Thank you for reporting an issue with RawTherapee. Before you continue, please check the following:
+1. Have you searched through the open and closed issues on GitHub for keywords related to your issue? If somebody else has already reported your issue, do not report it again. This is particularly important if you found an issue in a release version of RawTherapee, because many bugs will have been fixed already in the latest development builds.
+2. Have you read http://rawpedia.rawtherapee.com/How_to_write_useful_bug_reports ? This page describes how you can obtain as much useful information as possible to help the developers to quickly fix your issue.
+3. If your problem is related to a specific image file or edit, always (!) provide the image and corresponding sidecar (pp3) file.
+-->
+
+**Short description**
+<!-- Write a brief summary of the issue. Remove this section if you can fit the summary in the title of the issue. -->
+
+**Steps to reproduce**
+<!-- Provide the necessary steps to reproduce the issue. Using a list is not necessary, but recommended. For example:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error -->
+
+**Expected behavior**
+<!-- Explain what you observe, what you expected and why you think this is not correct behavior. -->
+
+**Additional information**
+<!-- Some essential information to provide along with your description:
+- Version of RawTherapee
+- Version of your operating system
+- If you built from source, the contents of the `AboutThisBuild.txt` file in the installation folder
+
+More information to provide:
+- Screenshots or screencast
+- Image file + sidecar (pp3)
+- Stacktrace from a debug build
+-->
diff --git a/.github/ISSUE_TEMPLATE/camera-support---color-calibration.md b/.github/ISSUE_TEMPLATE/camera-support---color-calibration.md
new file mode 100644
index 000000000..eaf57e20f
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/camera-support---color-calibration.md
@@ -0,0 +1,13 @@
+---
+name: Camera support / color calibration
+about: Report new file formats or requests for color calibration support here
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+<!-- If files from your camera cannot be opened by RawTherapee, or the colors do not look right, you can provide us with information to improve support for your camera. Before requesting making a request, please read http://rawpedia.rawtherapee.com/Adding_Support_for_New_Raw_Formats and make sure to provide the necessary shots.
+If you own a color calibration target (such as an X-Rite ColorChecker Passport), you can further improve the color rendition of files from your camera. Please read http://rawpedia.rawtherapee.com/How_to_create_DCP_color_profiles and provide the necessary shots.
+
+Requests for support or color calibration without providing the necessary information will be deleted. -->
diff --git a/.github/ISSUE_TEMPLATE/camera-support.md b/.github/ISSUE_TEMPLATE/camera-support.md
new file mode 100644
index 000000000..6d694f0a9
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/camera-support.md
@@ -0,0 +1,10 @@
+---
+name: Camera support
+about: Report new file formats or requests for color calibration support here
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+<!--
diff --git a/.github/ISSUE_TEMPLATE/feature-request---enhancements.md b/.github/ISSUE_TEMPLATE/feature-request---enhancements.md
new file mode 100644
index 000000000..8a2418bca
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature-request---enhancements.md
@@ -0,0 +1,15 @@
+---
+name: Feature request / enhancements
+about: Ideas and suggestions for improvement are always welcome!
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+<!-- READ THIS FIRST
+Please be advised that our current capacity for development is limited. Suggestions are always welcome, but we cannot guarantee that they will be looked into or implemented.
+Also make sure that you have searched through the open and closed issues on GitHub for keywords related to your suggestion. If somebody else has made the same suggestion, please do not report it again.
+-->
+
+<!-- Give a clear and complete description of WHAT your suggestion improvement is, WHY you think this would be useful or better, and, if possible, give as much input to describe HOW the improvement should be implemented. -->

From 3a6f91e9965bba8ca183f6805189da9b9ecbc3e7 Mon Sep 17 00:00:00 2001
From: Thanatomanic <6567747+Thanatomanic@users.noreply.github.com>
Date: Sat, 6 Feb 2021 08:54:24 +0100
Subject: [PATCH 2/2] Updated issue templates. More compact.

---
 .github/ISSUE_TEMPLATE/bug_report.md           | 18 +++++++++---------
 .../camera-support---color-calibration.md      |  4 ++--
 .github/ISSUE_TEMPLATE/camera-support.md       | 10 ----------
 .../feature-request---enhancements.md          |  6 +++---
 4 files changed, 14 insertions(+), 24 deletions(-)
 delete mode 100644 .github/ISSUE_TEMPLATE/camera-support.md

diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
index d6d418f42..fb9105078 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.md
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -8,32 +8,32 @@ assignees: ''
 ---
 
 <!-- READ THIS FIRST
-Thank you for reporting an issue with RawTherapee. Before you continue, please check the following:
-1. Have you searched through the open and closed issues on GitHub for keywords related to your issue? If somebody else has already reported your issue, do not report it again. This is particularly important if you found an issue in a release version of RawTherapee, because many bugs will have been fixed already in the latest development builds.
-2. Have you read http://rawpedia.rawtherapee.com/How_to_write_useful_bug_reports ? This page describes how you can obtain as much useful information as possible to help the developers to quickly fix your issue.
-3. If your problem is related to a specific image file or edit, always (!) provide the image and corresponding sidecar (pp3) file.
+Please check the following before you report:
+1. Search through the open and closed issues on GitHub for keywords related to your issue. Avoid creating duplicates. Many issues from the latest release version will already have been fixed.
+2. Read http://rawpedia.rawtherapee.com/How_to_write_useful_bug_reports to ensure you provide as much information as possible.
+3. If your problem is related to a specific image or edit, always (!) provide the image and corresponding sidecar (pp3) file.
 -->
 
 **Short description**
-<!-- Write a brief summary of the issue. Remove this section if you can fit the summary in the title of the issue. -->
+<!-- Give a brief summary of the issue. Remove this section if you can fit the summary in the title of the issue. -->
 
 **Steps to reproduce**
-<!-- Provide the necessary steps to reproduce the issue. Using a list is not necessary, but recommended. For example:
+<!-- Provide the necessary steps to reproduce the issue. For example:
 1. Go to '...'
 2. Click on '....'
 3. Scroll down to '....'
 4. See error -->
 
 **Expected behavior**
-<!-- Explain what you observe, what you expected and why you think this is not correct behavior. -->
+<!-- Explain the expected behavior and how it differs from the actual behavior. -->
 
 **Additional information**
-<!-- Some essential information to provide along with your description:
+<!-- Some essentials:
 - Version of RawTherapee
 - Version of your operating system
 - If you built from source, the contents of the `AboutThisBuild.txt` file in the installation folder
 
-More information to provide:
+Other useful information:
 - Screenshots or screencast
 - Image file + sidecar (pp3)
 - Stacktrace from a debug build
diff --git a/.github/ISSUE_TEMPLATE/camera-support---color-calibration.md b/.github/ISSUE_TEMPLATE/camera-support---color-calibration.md
index eaf57e20f..5b787c7aa 100644
--- a/.github/ISSUE_TEMPLATE/camera-support---color-calibration.md
+++ b/.github/ISSUE_TEMPLATE/camera-support---color-calibration.md
@@ -7,7 +7,7 @@ assignees: ''
 
 ---
 
-<!-- If files from your camera cannot be opened by RawTherapee, or the colors do not look right, you can provide us with information to improve support for your camera. Before requesting making a request, please read http://rawpedia.rawtherapee.com/Adding_Support_for_New_Raw_Formats and make sure to provide the necessary shots.
+<!-- If files from your camera cannot be opened by RawTherapee, or the colors are wrong, please provide information to improve support for your camera. Please read http://rawpedia.rawtherapee.com/Adding_Support_for_New_Raw_Formats and provide the necessary shots.
 If you own a color calibration target (such as an X-Rite ColorChecker Passport), you can further improve the color rendition of files from your camera. Please read http://rawpedia.rawtherapee.com/How_to_create_DCP_color_profiles and provide the necessary shots.
 
-Requests for support or color calibration without providing the necessary information will be deleted. -->
+Requests without providing the necessary information will be deleted. -->
diff --git a/.github/ISSUE_TEMPLATE/camera-support.md b/.github/ISSUE_TEMPLATE/camera-support.md
deleted file mode 100644
index 6d694f0a9..000000000
--- a/.github/ISSUE_TEMPLATE/camera-support.md
+++ /dev/null
@@ -1,10 +0,0 @@
----
-name: Camera support
-about: Report new file formats or requests for color calibration support here
-title: ''
-labels: ''
-assignees: ''
-
----
-
-<!--
diff --git a/.github/ISSUE_TEMPLATE/feature-request---enhancements.md b/.github/ISSUE_TEMPLATE/feature-request---enhancements.md
index 8a2418bca..9eccbe37c 100644
--- a/.github/ISSUE_TEMPLATE/feature-request---enhancements.md
+++ b/.github/ISSUE_TEMPLATE/feature-request---enhancements.md
@@ -8,8 +8,8 @@ assignees: ''
 ---
 
 <!-- READ THIS FIRST
-Please be advised that our current capacity for development is limited. Suggestions are always welcome, but we cannot guarantee that they will be looked into or implemented.
-Also make sure that you have searched through the open and closed issues on GitHub for keywords related to your suggestion. If somebody else has made the same suggestion, please do not report it again.
+Suggestions are always welcome, but we cannot guarantee that these can or will be implemented. Development capacity is limited.
+Please make sure to search through the open and closed issues for keywords related to your suggestion. Avoid creating duplicates.
 -->
 
-<!-- Give a clear and complete description of WHAT your suggestion improvement is, WHY you think this would be useful or better, and, if possible, give as much input to describe HOW the improvement should be implemented. -->
+<!-- Give a clear and complete description of WHAT your suggestion improvement is, WHY you think this would be useful or better, and ideally HOW the improvement should be implemented. -->