From 8f8d16849cf9cd48026f5af4add6f06e323eeae0 Mon Sep 17 00:00:00 2001
From: Derek Lewis <DerekNonGeneric@inf.is>
Date: Tue, 7 Jul 2020 11:01:11 -0400
Subject: [PATCH] meta: make issue template mobile friendly and address nits

PR-URL: https://github.com/nodejs/node/pull/34243
Reviewed-By: Anna Henningsen <anna@addaleax.net>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Evan Lucas <evanlucas@me.com>
Reviewed-By: Trivikram Kamat <trivikr.dev@gmail.com>
Reviewed-By: Rich Trott <rtrott@gmail.com>
Reviewed-By: Anto Aravinth <anto.aravinth.cse@gmail.com>
---
 .../ISSUE_TEMPLATE/3-api-ref-docs-problem.md  | 59 +++++++++++++------
 1 file changed, 41 insertions(+), 18 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/3-api-ref-docs-problem.md b/.github/ISSUE_TEMPLATE/3-api-ref-docs-problem.md
index 3ec3959eb67173..f63d540abaf4e2 100644
--- a/.github/ISSUE_TEMPLATE/3-api-ref-docs-problem.md
+++ b/.github/ISSUE_TEMPLATE/3-api-ref-docs-problem.md
@@ -7,29 +7,48 @@ labels: doc
 
 # 📗 API Reference Docs Problem
 
-<!------------------------------------------------------------------------------
+<!--
+
 Thank you for wanting to make nodejs.org better!
 
-This template is for issues with the Node.js API reference docs.
+This template is for issues with the Node.js API
+reference documentation.
 
-For more general support, please open an issue in
-our help repo at “https://github.com/nodejs/help”.
+For problems with nodejs.org beyond the API
+reference documentation, please open an issue
+using the issue tracker for our site repository.
 
-For the issue title, enter a one-line summary after “doc: ”.
-The “✍️” signifies a request for input. If unsure, do the best you can.
+  https://github.com/nodejs/nodejs.org
 
-If you found a problem with nodejs.org beyond the API reference docs, please
-open an issue in our website repo at “https://github.com/nodejs/nodejs.org”.
-------------------------------------------------------------------------------->
+For more general support, please open an issue
+using the issue tracker for our help repository.
+
+  https://github.com/nodejs/help
+
+---
+
+For the issue title, please enter a one-line
+summary after “doc: ” (preferably 50 characters
+or less and no more than 72).
+
+The “✍️” are placeholders signifying requests for
+input. Replace them with your responses.
+
+If you are unsure of something, do your best.
 
-<!--
-Version: output of “node -v”
-Platform: output of “uname -a” (UNIX), or version and 32 or 64-bit (Windows)
-Subsystem: if known, please specify affected core module name
 -->
 
+<!-- The output of “node --version”. -->
+
 - **Version**: ✍️
+
+<!-- The output of “uname -a” (UNIX) or version
+and 32-bit or 64-bit (Windows). -->
+
 - **Platform**: ✍️
+
+<!-- The name of affected core module. -->
+
 - **Subsystem**: ✍️
 
 ## Location
@@ -37,18 +56,22 @@ Subsystem: if known, please specify affected core module name
 _Section of the site where the content exists_
 
 Affected URL(s):
+
 - https://nodejs.org/api/✍️
 
-## Problem description
+## Description
 
-_Concise explanation of what you found to be problematic_
+_Concise explanation of the problem_
 
-<!-- If applicable, include any screenshots that may help solve the problem. -->
+<!-- If applicable, include any screenshots that
+may help solve the problem. -->
 
 ✍️
 
 ---
 
-<!-- Use “[x]” to check the box below if interested in contributing. -->
+<!-- Use “[x]” to check the box below if you are
+interested in contributing. -->
 
-- [ ] I would like to work on this issue and submit a pull request.
+- [ ] I would like to work on this issue and
+      submit a pull request.