From d378750ebb8ec3e2e56bdbefa2266d1f0b5865d0 Mon Sep 17 00:00:00 2001
From: Mason Daugherty <github@mdrxy.com>
Date: Mon, 13 Oct 2025 22:02:54 -0400
Subject: [PATCH] fix issue template ordering, add template for ref docs

---
 .../{langchain.yml => 01-langchain.yml}       |  0
 .../{langgraph.yml => 02-langgraph.yml}       |  0
 .../{langsmith.yml => 03-langsmith.yml}       |  0
 ...platform.yml => 04-langgraph-platform.yml} |  0
 ...ngchain-labs.yml => 05-langchain-labs.yml} |  0
 .github/ISSUE_TEMPLATE/06-reference-docs.yml  | 54 +++++++++++++++++++
 6 files changed, 54 insertions(+)
 rename .github/ISSUE_TEMPLATE/{langchain.yml => 01-langchain.yml} (100%)
 rename .github/ISSUE_TEMPLATE/{langgraph.yml => 02-langgraph.yml} (100%)
 rename .github/ISSUE_TEMPLATE/{langsmith.yml => 03-langsmith.yml} (100%)
 rename .github/ISSUE_TEMPLATE/{langgraph-platform.yml => 04-langgraph-platform.yml} (100%)
 rename .github/ISSUE_TEMPLATE/{langchain-labs.yml => 05-langchain-labs.yml} (100%)
 create mode 100644 .github/ISSUE_TEMPLATE/06-reference-docs.yml

diff --git a/.github/ISSUE_TEMPLATE/langchain.yml b/.github/ISSUE_TEMPLATE/01-langchain.yml
similarity index 100%
rename from .github/ISSUE_TEMPLATE/langchain.yml
rename to .github/ISSUE_TEMPLATE/01-langchain.yml
diff --git a/.github/ISSUE_TEMPLATE/langgraph.yml b/.github/ISSUE_TEMPLATE/02-langgraph.yml
similarity index 100%
rename from .github/ISSUE_TEMPLATE/langgraph.yml
rename to .github/ISSUE_TEMPLATE/02-langgraph.yml
diff --git a/.github/ISSUE_TEMPLATE/langsmith.yml b/.github/ISSUE_TEMPLATE/03-langsmith.yml
similarity index 100%
rename from .github/ISSUE_TEMPLATE/langsmith.yml
rename to .github/ISSUE_TEMPLATE/03-langsmith.yml
diff --git a/.github/ISSUE_TEMPLATE/langgraph-platform.yml b/.github/ISSUE_TEMPLATE/04-langgraph-platform.yml
similarity index 100%
rename from .github/ISSUE_TEMPLATE/langgraph-platform.yml
rename to .github/ISSUE_TEMPLATE/04-langgraph-platform.yml
diff --git a/.github/ISSUE_TEMPLATE/langchain-labs.yml b/.github/ISSUE_TEMPLATE/05-langchain-labs.yml
similarity index 100%
rename from .github/ISSUE_TEMPLATE/langchain-labs.yml
rename to .github/ISSUE_TEMPLATE/05-langchain-labs.yml
diff --git a/.github/ISSUE_TEMPLATE/06-reference-docs.yml b/.github/ISSUE_TEMPLATE/06-reference-docs.yml
new file mode 100644
index 000000000..831ba5393
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/06-reference-docs.yml
@@ -0,0 +1,54 @@
+name: Reference Documentation
+description: Report an issue related to API reference documentation.
+title: "[reference]: <Please write a comprehensive title>"
+labels: [reference]
+
+body:
+  - type: dropdown
+    attributes:
+      label: "Type of issue"
+      description: "What type of reference documentation issue are you reporting?"
+      options:
+        - issue / bug
+        - missing documentation
+        - incorrect type signature
+        - outdated/deprecated content
+        - other
+      default: 0
+    validations:
+      required: true
+  - type: dropdown
+    attributes:
+      label: "Language"
+      description: "What language is the reference documentation issue related to?"
+      options:
+        - Python
+        - JavaScript
+        - N/A
+      default: 0
+    validations:
+      required: true
+  - type: dropdown
+    attributes:
+      label: "Product"
+      description: "Which product's reference docs is this issue related to?"
+      options:
+        - LangChain
+        - LangGraph
+        - LangSmith
+        - Other
+      default: 0
+  - type: input
+    attributes:
+      label: "Link to reference page"
+      description: "URL to the specific reference page with the issue (if applicable)"
+  - type: textarea
+    attributes:
+      label: "Description"
+      description: >
+        Please describe your issue in detail.
+        For missing documentation, specify the class/method/function that needs documentation.
+        For incorrect signatures, provide the expected vs. actual signature.
+        For bugs, include what you expected to see vs. what you actually see.
+    validations:
+      required: true