feat(website): add japanese and simplified chinese docs with i18n, translation issue flow

2 files changed, 64 insertions, 0 deletions

diff --git a/.github/ISSUE_TEMPLATE/translation.yml b/.github/ISSUE_TEMPLATE/translation.yml
new file mode 100644
index 00000000..ae8557b5
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/translation.yml
@@ -0,0 +1,54 @@
+name: Translation issue
+description: Report an incorrect or unclear translation in the herdr docs.
+labels: ["translation"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Docs translations are LLM-generated from the English source. Reports about wrong, unclear, or unnatural translations are welcome here.
+
+        For bugs in herdr itself, use the bug report template instead.
+
+  - type: checkboxes
+    id: translation-confirmation
+    attributes:
+      label: Is this a translation issue?
+      description: Bugs belong in the bug report template. Feature requests, ideas, and questions belong in Discussions.
+      options:
+        - label: I confirm this is a translation issue in the herdr docs, not a bug report, feature request, or question.
+          required: true
+
+  - type: input
+    id: page
+    attributes:
+      label: Page
+      description: URL of the affected docs page.
+      placeholder: https://herdr.dev/ja/docs/quick-start/
+    validations:
+      required: true
+
+  - type: dropdown
+    id: language
+    attributes:
+      label: Language
+      options:
+        - 日本語 (Japanese)
+        - 简体中文 (Simplified Chinese)
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: What is wrong
+      description: Quote the incorrect or unclear text and explain the problem. Writing in Japanese or Chinese is fine.
+    validations:
+      required: true
+
+  - type: textarea
+    id: suggestion
+    attributes:
+      label: Suggested correction
+      description: Optional. How should it read instead?
+    validations:
+      required: false
diff --git a/.github/workflows/issue-gate.yml b/.github/workflows/issue-gate.yml
index ff7a22d9..dd93e02b 100644
--- a/.github/workflows/issue-gate.yml
+++ b/.github/workflows/issue-gate.yml
@@ -120,6 +120,16 @@ jobs:
             }
 
             const body = issue.body || '';
+            const translationConfirmationPattern = /^\s*-\s*\[[xX]\]\s*I confirm this is a translation issue in the herdr docs, not a bug report, feature request, or question\.\s*$/m;
+            const translationSections = ['### Page', '### Language', '### What is wrong'];
+            if (
+              translationConfirmationPattern.test(body) &&
+              translationSections.every((section) => body.includes(section))
+            ) {
+              console.log(`#${issue.number} matches the translation issue template; leaving issue open`);
+              return;
+            }
+
             const hasBugConfirmation = bugConfirmationPattern.test(body);
             const hasBugTemplate = requiredSections.every((section) => body.includes(section));
             const allowedHeadings = new Set(requiredSections);