From ebbcb51de0d1ac3ce4065fb37be6eaaf847a0f32 Mon Sep 17 00:00:00 2001
From: Janek <27jf@pm.me>
Date: Mon, 1 Nov 2021 23:21:23 +0100
Subject: [PATCH] ISSUE_TEMPLATE, PULL_REQUEST_TEMPLATE: refresh (#6556)

---
 .github/ISSUE_TEMPLATE.md        | 14 ++++++++++----
 .github/PULL_REQUEST_TEMPLATE.md | 10 +++++-----
 2 files changed, 15 insertions(+), 9 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE.md b/.github/ISSUE_TEMPLATE.md
index 5a089dd1b..b29fdd407 100644
--- a/.github/ISSUE_TEMPLATE.md
+++ b/.github/ISSUE_TEMPLATE.md
@@ -1,9 +1,15 @@
 <!--
-Thank you for reporting an issue! Please review the following notes before submitting it.
+Thank you for reporting an issue!
+Please review the following notes before submission.
 
-Most issues on this repo are requests for new commands. If it's the case, make sure to use the standard title ("page request: <command name>"), and include a link to a web page about the command, and if possible, to an existing source of example-style documentation.
+If you request a new command, please:
+- use the standard title ("page request: <command name>")
+- include a link to a web page about the command
+- if available, add an existing source of examples
 
-If your issue is with a particular client of tldr-pages, please raise the issue in the repo for that client. For example, if you are using the node client, you would report the issue here: https://github.com/tldr-pages/tldr-node-client/issues
+If your issue is with a particular tldr client, please report the issue there.
+For example, issues for the Node.js client should be reported at https://github.com/tldr-pages/tldr-node-client/issues
 
-If you have a general question or are not sure whether to open an issue, please feel free to ask in our Gitter channel: https://gitter.im/tldr-pages/tldr
+If you have a general question or are not sure whether to open an issue,
+ask away in our Gitter channel: https://gitter.im/tldr-pages/tldr
 -->
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index 9f8dd2067..53022dc8f 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -1,8 +1,8 @@
-<!-- Thank you for sending a PR! -->
-<!-- Relevant links - https://github.com/tldr-pages/tldr/blob/main/CONTRIBUTING.md#commit-message -->
-<!-- https://github.com/tldr-pages/tldr/blob/main/CONTRIBUTING.md#guidelines -->
-<!-- Please perform the following checks and mark all the boxes accordingly. -->
-<!-- You can remove the checklist items that don't apply to your PR. -->
+<!--
+Thank you for contributing!
+Please fill in the following checklist, removing items that do not apply.
+See also https://github.com/tldr-pages/tldr/blob/main/CONTRIBUTING.md
+-->
 
 - [ ] The page (if new), does not already exist in the repository.
 - [ ] The page is in the correct platform directory (`common/`, `linux/`, etc.)