From 50502150ff477d0cf04dd96de8a70253391dae3c Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 2 Jul 2026 12:51:31 +0000
Subject: [PATCH] Fix review comments: correct translation language codes and
 align CLA URL in CONTRIBUTING.md

---
 .github/ISSUE_TEMPLATE/lesson_correction.yml  | 25 ++++++++++++
 .../ISSUE_TEMPLATE/translation_feedback.yml   | 40 +++++++++++++++++++
 CONTRIBUTING.md                               | 22 ++++++++++
 3 files changed, 87 insertions(+)
 create mode 100644 .github/ISSUE_TEMPLATE/lesson_correction.yml
 create mode 100644 .github/ISSUE_TEMPLATE/translation_feedback.yml
 create mode 100644 CONTRIBUTING.md

diff --git a/.github/ISSUE_TEMPLATE/lesson_correction.yml b/.github/ISSUE_TEMPLATE/lesson_correction.yml
new file mode 100644
index 00000000..d3cd835b
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/lesson_correction.yml
@@ -0,0 +1,25 @@
+name: "✍️ Lesson Correction / Typo"
+description: "Suggest corrections to spelling, broken links, or code errors in a lesson notebook"
+title: "[Correction]: "
+labels: ["bug", "documentation"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for helping us improve our lessons! Please fill out the form below.
+  - type: input
+    id: lesson_name
+    attributes:
+      label: "Lesson Name or File Path"
+      description: "Which week, lesson, or notebook file path contains the error?"
+      placeholder: "e.g., lessons/3-NeuralNetworks/03-Perceptron/README.md"
+    validations:
+      required: true
+  - type: textarea
+    id: error_details
+    attributes:
+      label: "Correction Details"
+      description: "Describe what is incorrect and what the correct spelling or code should be."
+      placeholder: "The link to the PyTorch docs in section 3 is broken, it should point to..."
+    validations:
+      required: true
diff --git a/.github/ISSUE_TEMPLATE/translation_feedback.yml b/.github/ISSUE_TEMPLATE/translation_feedback.yml
new file mode 100644
index 00000000..4c65b2ec
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/translation_feedback.yml
@@ -0,0 +1,40 @@
+name: "🌐 Translation Feedback"
+description: "Suggest improvements or submit translations for a language"
+title: "[Translation]: "
+labels: ["translation"]
+body:
+  - type: dropdown
+    id: language
+    attributes:
+      label: "Target Language"
+      options:
+        - Arabic (ar)
+        - German (de)
+        - Spanish (es)
+        - French (fr)
+        - Hindi (hi)
+        - Indonesian (id)
+        - Italian (it)
+        - Japanese (ja)
+        - Korean (ko)
+        - Dutch (nl)
+        - Polish (pl)
+        - Portuguese - Brazil (pt-BR)
+        - Portuguese - Portugal (pt-PT)
+        - Russian (ru)
+        - Turkish (tr)
+        - Ukrainian (uk)
+        - Vietnamese (vi)
+        - Simplified Chinese (zh-CN)
+        - Traditional Chinese - Taiwan (zh-TW)
+        - Traditional Chinese - Hong Kong (zh-HK)
+        - Other (please specify in details)
+    validations:
+      required: true
+  - type: textarea
+    id: details
+    attributes:
+      label: "Details"
+      description: "Specify the translation feedback, grammatical fixes, or new translation files you plan to submit."
+    validations:
+      required: true
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 00000000..bc03bfb6
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,22 @@
+# Contributing to AI-For-Beginners
+
+Thank you for your interest in contributing to AI-For-Beginners! We welcome translations, lesson fixes, and formatting corrections.
+
+## Microsoft Contributor License Agreement (CLA)
+
+This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit [https://cla.microsoft.com](https://cla.microsoft.com).
+
+When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repositories using our CLA.
+
+## How to Contribute
+
+### 1. Fixing Typos / Code Errors
+If you find a typo or bug in any Jupyter notebook or lesson markdown file:
+1. Fork the repository.
+2. Fix the typo or broken link.
+3. Submit a Pull Request with a clear description of the fix.
+
+### 2. Submitting Translations
+We welcome translations of the lessons into other languages! Please place translations under the `translations/` directory using standard ISO language codes (e.g. `translations/es/`).
+
+For more details, see [etc/CONTRIBUTING.md](etc/CONTRIBUTING.md).