From 68242dce5fec7b842d1677f386d8ff2d6ff3703e Mon Sep 17 00:00:00 2001
From: Derek Lewis <DerekNonGeneric@inf.is>
Date: Mon, 20 Apr 2020 09:56:25 -0400
Subject: [PATCH 1/3] meta: add issue template for API reference docs

Prior to this commit, there was no GitHub issue template guiding
users to open issues about gaps in the API reference docs.

Refs: https://github.com/nodejs/node/pull/31123
Closes: https://github.com/nodejs/nodejs.org/issues/2866
---
 .../ISSUE_TEMPLATE/3-api-ref-docs-problem.md  | 74 +++++++++++++++++++
 1 file changed, 74 insertions(+)
 create mode 100644 .github/ISSUE_TEMPLATE/3-api-ref-docs-problem.md

diff --git a/.github/ISSUE_TEMPLATE/3-api-ref-docs-problem.md b/.github/ISSUE_TEMPLATE/3-api-ref-docs-problem.md
new file mode 100644
index 00000000000000..d33ed1598a6620
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/3-api-ref-docs-problem.md
@@ -0,0 +1,74 @@
+---
+name: "\U0001F4D7 Open an issue regarding the nodejs.org API reference docs"
+about: Let us know about any problematic API reference documents
+title: "doc: "
+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.
+
+If you found a problem with nodejs.org beyond the API reference docs, please
+file an issue in our website repo at “https://github.com/nodejs/nodejs.org”.
+
+For the issue title, enter a one-line summary after “doc: ”. If unsure about
+something, please do the best you can.
+
+The “✍️” signifies a request for input.
+
+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
+-->
+
+- **Version**: ✍️
+- **Platform**: ✍️
+- **Subsystem**: ✍️
+
+## Problem type
+
+<!-- ✍️ Use “[x]” to mark a selection. -->
+
+- [ ] Missing
+- [ ] Needed
+- [ ] Confusing
+- [ ] Didn't work
+- [ ] Other (<!-- ? Please specify if chosen. -->)
+
+## Location
+
+_Section of the site where the content lives (or should)._
+
+Affected URL(s):
+
+- https://nodejs.org/api/✍️
+
+## Reproduction procedure
+
+_Steps to reproduce the problem_
+
+✍️
+
+## Expected behavior/code
+
+_What you were expecting._
+
+✍️
+
+## Additional information
+
+_Any other information that would be helpful to solve this._
+
+<!-- ? Enter “n/a” if enough details exist elsewhere in this template. -->
+
+✍️
+
+---
+
+<!-- ? Use “[x]” to check the box below if interested in contributing. -->
+
+- [ ] I would like to work on this issue and submit a pull request.

From 7d7d92778ec79631d847e8fef0b86b664ca29f73 Mon Sep 17 00:00:00 2001
From: Derek Lewis <DerekNonGeneric@inf.is>
Date: Wed, 29 Apr 2020 03:29:49 -0400
Subject: [PATCH 2/3] fixup! meta: add issue template for API reference docs

---
 .../ISSUE_TEMPLATE/3-api-ref-docs-problem.md  | 44 +++++++++----------
 1 file changed, 21 insertions(+), 23 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/3-api-ref-docs-problem.md b/.github/ISSUE_TEMPLATE/3-api-ref-docs-problem.md
index d33ed1598a6620..a20643447df209 100644
--- a/.github/ISSUE_TEMPLATE/3-api-ref-docs-problem.md
+++ b/.github/ISSUE_TEMPLATE/3-api-ref-docs-problem.md
@@ -1,5 +1,5 @@
 ---
-name: "\U0001F4D7 Open an issue regarding the nodejs.org API reference docs"
+name: "\U0001F4D7 Open an issue regarding the Node.js API reference docs"
 about: Let us know about any problematic API reference documents
 title: "doc: "
 labels: doc
@@ -7,19 +7,22 @@ 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.
 
-If you found a problem with nodejs.org beyond the API reference docs, please
-file an issue in our website repo at “https://github.com/nodejs/nodejs.org”.
+For more general support, please open an issue in
+our help repo at “https://github.com/nodejs/help”.
 
-For the issue title, enter a one-line summary after “doc: ”. If unsure about
-something, please do the best you can.
+For the issue title, enter a one-line summary after “doc: ”.
+The “✍️” signifies a request for input. If unsure, do the best you can.
 
-The “✍️” signifies a request for input.
+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”.
+------------------------------------------------------------------------------->
 
+<!--
 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
@@ -29,22 +32,11 @@ Subsystem: if known, please specify affected core module name
 - **Platform**: ✍️
 - **Subsystem**: ✍️
 
-## Problem type
-
-<!-- ✍️ Use “[x]” to mark a selection. -->
-
-- [ ] Missing
-- [ ] Needed
-- [ ] Confusing
-- [ ] Didn't work
-- [ ] Other (<!-- ? Please specify if chosen. -->)
-
 ## Location
 
-_Section of the site where the content lives (or should)._
+_Section of the site where the content exists (or should)_
 
 Affected URL(s):
-
 - https://nodejs.org/api/✍️
 
 ## Reproduction procedure
@@ -55,20 +47,26 @@ _Steps to reproduce the problem_
 
 ## Expected behavior/code
 
-_What you were expecting._
+_What your expectation was_
+
+✍️
+
+## Actual behavior/code
+
+_What you found to be problematic_
 
 ✍️
 
 ## Additional information
 
-_Any other information that would be helpful to solve this._
+_Anything else (e.g., screenshots, etc.) that may help solve the problem_
 
-<!-- ? Enter “n/a” if enough details exist elsewhere in this template. -->
+<!-- Enter “n/a” if enough detail exists elsewhere in this template. -->
 
 ✍️
 
 ---
 
-<!-- ? Use “[x]” to check the box below if interested in contributing. -->
+<!-- Use “[x]” to check the box below if interested in contributing. -->
 
 - [ ] I would like to work on this issue and submit a pull request.

From 426933642f07854814cf435c4ac57cbf6fa7a7d5 Mon Sep 17 00:00:00 2001
From: Derek Lewis <DerekNonGeneric@inf.is>
Date: Wed, 29 Apr 2020 21:14:50 -0400
Subject: [PATCH 3/3] fixup! meta: add issue template for API reference docs

---
 .../ISSUE_TEMPLATE/3-api-ref-docs-problem.md  | 26 +++----------------
 1 file changed, 4 insertions(+), 22 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/3-api-ref-docs-problem.md b/.github/ISSUE_TEMPLATE/3-api-ref-docs-problem.md
index a20643447df209..3ec3959eb67173 100644
--- a/.github/ISSUE_TEMPLATE/3-api-ref-docs-problem.md
+++ b/.github/ISSUE_TEMPLATE/3-api-ref-docs-problem.md
@@ -34,34 +34,16 @@ Subsystem: if known, please specify affected core module name
 
 ## Location
 
-_Section of the site where the content exists (or should)_
+_Section of the site where the content exists_
 
 Affected URL(s):
 - https://nodejs.org/api/✍️
 
-## Reproduction procedure
+## Problem description
 
-_Steps to reproduce the problem_
+_Concise explanation of what you found to be problematic_
 
-✍️
-
-## Expected behavior/code
-
-_What your expectation was_
-
-✍️
-
-## Actual behavior/code
-
-_What you found to be problematic_
-
-✍️
-
-## Additional information
-
-_Anything else (e.g., screenshots, etc.) that may help solve the problem_
-
-<!-- Enter “n/a” if enough detail exists elsewhere in this template. -->
+<!-- If applicable, include any screenshots that may help solve the problem. -->
 
 ✍️