chore(i18n): sync translations with latest source changes (chunk 1/1, 6 changes)

5 months ago · 56eac86043
parent 74e656e6fb
commit 56eac86043
6 changed files with 526 additions and 526 deletions
--- a/translations/pa/.co-op-translator.json
+++ b/translations/pa/.co-op-translator.json
@ -493,7 +493,7 @@
  },
  "AGENTS.md": {
    "original_hash": "a362efd06d64d4134a0cfe8515a86d34",
-    "translation_date": "2026-04-06T16:38:39+00:00",
+    "translation_date": "2026-04-20T15:48:43+00:00",
    "source_file": "AGENTS.md",
    "language_code": "pa"
  },
--- a/translations/pa/AGENTS.md
+++ b/translations/pa/AGENTS.md
@ -1,37 +1,37 @@
 # AGENTS.md
-## ਪ੍ਰੋਜੈਕਟ ਝਲਕ
+## ਪ੍ਰੋਜੈਕਟ ਓਵਰਵਿਊ
-ਇਹ ਸ਼ੁਰੂਆਤੀ ਸਤਰਾ ਲਈ ਵੈੱਬ ਵਿਕਾਸ ਮੂਲਭੂਤਾਂ ਸਿਖਾਉਣ ਲਈ ਸਿੱਖਿਆ ਕੋਰਸ ਰਿਪੋਜ਼ਿਟਰੀ ਹੈ। ਇਹ ਕੋਰਸ 12 ਹਫ਼ਤੇ ਦਾ ਵਿਸਥਾਰਿਕ ਕੋਰਸ ਹੈ ਜੋ Microsoft Cloud Advocates ਵੱਲੋਂ ਤਿਆਰ ਕੀਤਾ ਗਿਆ ਹੈ, ਜਿਸ ਵਿੱਚ 24 ਪ੍ਰਯੋਗਕਾਰੀ ਪਾਠ ਹਨ ਜੋ ਜਾਵਾਸਕ੍ਰਿਪਟ, CSS ਅਤੇ HTML ਨੂੰ ਕਵਰ ਕਰਦੇ ਹਨ।
+ਇਹ शुरुआਤੀ ਵੈੱਬ ਵਿੱਕਾਸ਼ ਮੂਲਾਂਕਣ ਸਿਖਾਉਣ ਲਈ ਇੱਕ ਸਿੱਖਣਯੋਗ ਸਿਲੇਬਸ ਰਿਪੋਜ਼ਿਟਰੀ ਹੈ। ਇਹ ਸਿਲੇਬਸ ਮਾਈਕ੍ਰੋਸਾਫਟ ਕਲਾਉਡ ਅਡਵੋਕੇਟਸ ਵੱਲੋਂ ਵਿਕਸੀਤ ਇੱਕ ਸਮੱਗਰੀਤ 12 ਹਫ਼ਤਿਆਂ ਦਾ ਕੋਰਸ ਹੈ, ਜਿਸ ਵਿੱਚ JavaScript, CSS, ਅਤੇ HTML ਦੀਆਂ 24 ਪ੍ਰਯੋਗਸ਼ੀਲ ਲੈਸਨਾਂ ਸ਼ਾਮਲ ਹਨ।
-### ਮੁੱਖ ਹਿੱਸੇ
+### ਮੁੱਖ ਘਟਕ
- **ਸਿੱਖਿਆ ਸਮੱਗਰੀ**: 24 ਸਰਗੰਥਿਤ ਪਾਠ ਪ੍ਰੋਜੈਕਟ-ਆਧਾਰਿਤ ਮੌਡੀਊਲਾਂ ਵਿੱਚ ਵੰਡੇ ਹੋਏ
+- **ਸਿੱਖਣਯੋਗ ਸਮੱਗਰੀ**: ਪ੍ਰੋਜੈਕਟ-ਆਧਾਰਿਤ ਮੋਡਿਊਲਾਂ ਵਿੱਚ ਵਿਵਸਥਿਤ 24 ਪਾਠ
- **ਵਿਆਵਹਾਰਿਕ ਪ੍ਰੋਜੈਕਟ**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, ਅਤੇ AI Chat Assistant
+- **ਪ੍ਰਯੋਗਸ਼ੀਲ ਪ੍ਰੋਜੈਕਟ**: ਟੈਰੀਆਰਿਯਮ, ਟਾਈਪਿੰਗ ਗੇਮ, ਬਰਾਊਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ, ਸਪੇਸ ਗੇਮ, ਬੈਂਕਿੰਗ ਐਪ, ਕੋਡ ਐਡੀਟਰ, ਅਤੇ AI ਚੈਟ ਅਸਿਸਟੈਂਟ
- **ਇੰਟਰਐਕਟਿਵ ਕੁਇਜ਼**: 48 ਕੁਇਜ਼, ਹਰ ਇੱਕ ਵਿੱਚ 3 ਸਵਾਲ (ਪੂਰਵ/ਪੋਸਟ-ਪਾਠ ਅੰਕੜੇ)
+- **ਇੰਟਰਐਕਟਿਵ ਕਵਿਜ਼**: 48 ਕਵਿਜ਼, ਹਰ ਇੱਕ ਵਿੱਚ 3 ਸਵਾਲ (ਪਹਿਲਾਂ/ਬਾਅਦ ਲੈਸਨ ਮੁਲਾਂਕਣ)
- **ਬਹੁਭਾਸ਼ੀ ਸਹਿਯੋਗ**: GitHub Actions ਦੁਆਰਾ 50+ ਭਾਸ਼ਾਵਾਂ ਵਿੱਚ 자동 ਅਨੁਵਾਦ
+- **ਬਹੁ-ਭਾਸ਼ਾ ਸਹਾਇਤਾ**: GitHub Actions ਦੁਆਰਾ 50+ ਭਾਸ਼ਾਵਾਂ ਵਿੱਚ ਆਟੋਮੈਟਿਕ ਅਨੁਵਾਦ
- **ਤਕਨੀਕਾਂ**: HTML, CSS, ਜਾਵਾਸਕ੍ਰਿਪਟ, Vue.js 3, Vite, Node.js, Express, Python (AI ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ)
+- **ਤਕਨੀਕਾਂ**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ)
-### ਬਣਤਰ
+### ਵਿਸ਼ੇਸ਼ ਰਚਨਾ
- ਸਿੱਖਿਆ ਸਮੱਗਰੀ ਨੂੰ ਪਾਠ-ਆਧਾਰਿਤ ਬਣਤਰ ਵਿੱਚ ਰੱਖਿਆ ਗਿਆ
+- ਪਾਠ ਅਧਾਰਿਤ ਸਿੱਖਣਯੋਗ ਰਿਪੋਜ਼ਿਟਰੀ
- ਹਰ ਪਾਠ ਫੋਲਡਰ ਵਿੱਚ README, ਕੋਡ ਉਦਾਹਰਣਾਂ ਅਤੇ ਹੱਲ ਹੁੰਦੇ ਹਨ
+- ਹਰ ਪਾਠ ਫੋਲਡਰ README, ਕੋਡ ਉਦਾਹਰਣਾਂ, ਅਤੇ ਸਮਾਧਾਨਾਂ ਨਾਲ ਭਰਪੂਰ
- ਅਲੱਗ ਅਲੱਗ ਡਾਇਰੈਕਟਰੀਜ਼ ਵਿੱਚ ਅਲੱਗ ਪ੍ਰੋਜੈਕਟ (quiz-app, ਵੱਖਰੇ ਪਾਠ ਪ੍ਰੋਜੈਕਟ)
+- ਵੱਖ-ਵੱਖ ਡਾਇਰੈਕਟਰੀਆਂ ਵਿੱਚ ਅਲੱਗ ਪ੍ਰੋਜੈਕਟ (quiz-app, ਅਨੇਕ ਪਾਠ ਪ੍ਰੋਜੈਕਟ)
- GitHub Actions (co-op-translator) ਨਾਲ ਅਨੁਵਾਦ ਪ੍ਰਣਾਲੀ
+- GitHub Actions (co-op-translator) ਨਾਲ ਅਨੁਵਾਦ ਸਿਸਟਮ
- Docsify ਰਾਹੀਂ ਦਸਤਾਵੇਜ਼ ਵੈਂਟਰੇ ਅਤੇ PDF ਰੂਪ ਵਿੱਚ ਉਪਲਬਧ
+- Docsify ਰਾਹੀਂ ਦਸਤਾਵੇਜ਼ ਸੇਵਾ ਅਤੇ PDF ਉਪਲਬਧ
-## ਸੈੱਟਅੱਪ ਕਮਾਂਡਾਂ
+## ਸੈਟਅਪ ਕਮਾਂਡਾਂ
-ਇਹ ਰਿਪੋਜ਼ਿਟਰੀ ਮੁੱਖ ਰੂਪ ਵਿੱਚ ਸਿੱਖਿਆ ਸਮੱਗਰੀ ਵਰਤੋਂ ਲਈ ਹੈ। ਵਿਸ਼ੇਸ਼ ਪ੍ਰੋਜੈਕਟਾਂ ਨਾਲ ਕੰਮ ਕਰਨ ਲਈ:
+ਇਹ ਰਿਪੋਜ਼ਿਟਰੀ ਮੁੱਖ ਤੌਰ ਤੇ ਸਿੱਖਣਯੋਗ ਸਮੱਗਰੀ ਦੇ ਪ੍ਰਯੋਗ ਲਈ ਹੈ। ਨਿਰਧਾਰਿਤ ਪ੍ਰੋਜੈਕਟਾਂ ਨਾਲ ਕੰਮ ਕਰਨ ਲਈ:
-### ਮੁੱਖ ਰਿਪੋਜ਼ਿਟਰੀ ਸੈੱਟਅੱਪ
+### ਮੁੱਖ ਰਿਪੋਜ਼ਿਟਰੀ ਸੈਟਅਪ
 ```bash
 git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
 cd Web-Dev-For-Beginners
 ```
-### Quiz App ਸੈੱਟਅੱਪ (Vue 3 + Vite)
+### ਕਵਿਜ਼ ਐਪ ਸੈਟਅਪ (Vue 3 + Vite)
 ```bash
 cd quiz-app
@ -41,242 +41,242 @@ npm run build      # ਉਤਪਾਦਨ ਲਈ ਬਿਲਡ ਕਰੋ
 npm run lint       # ESLint ਚਲਾਓ
 ```
-### Bank ਪ੍ਰੋਜੈਕਟ API (Node.js + Express)
+### ਬੈਂਕ ਪ੍ਰੋਜੈਕਟ API (Node.js + Express)
 ```bash
 cd 7-bank-project/api
 npm install
 npm start          # ਏਪੀਆਈ ਸਰਵਰ ਸ਼ੁਰੂ ਕਰੋ
 npm run lint       # ESLint ਚਲਾਓ
-npm run format     # Prettier ਨਾਲ ਫਾਰਮੈਟ ਕਰੋ
+npm run format     # ਪ੍ਰੀਟੀਅਰ ਨਾਲ ਫਾਰਮੇਟ ਕਰੋ
 ```
-### Browser Extension ਪ੍ਰੋਜੈਕਟ
+### ਬਰਾਊਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ ਪ੍ਰੋਜੈਕਟ
 ```bash
 cd 5-browser-extension/solution
 npm install
-# ਬ੍ਰਾਊਜ਼ਰ-ਖਾਸ ਐਕਸਟੈਂਸ਼ਨ ਲੋਡਿੰਗ ਨਿਰਦੇਸ਼ਾਂ ਦੀ ਪਾਲਣਾ ਕਰੋ
+# ਬਰਾਊਜ਼ਰ-ਵਿਸ਼ੇਸ਼ ਐਕਸਟੈਂਸ਼ਨ ਲੋਡ ਕਰਨ ਦੇ ਨਿਰਦੇਸ਼ਾਂ ਦਾ ਪਾਲਣ ਕਰੋ
 ```
-### Space Game ਪ੍ਰੋਜੈਕਟ
+### ਸਪੇਸ ਗੇਮ ਪ੍ਰੋਜੈਕਟ
 ```bash
 cd 6-space-game/solution
 npm install
-# ਇੰਡੈਕਸ.html ਨੂੰ ਬ੍ਰਾਊਜ਼ਰ ਵਿੱਚ ਖੋਲ੍ਹੋ ਜਾਂ ਲਾਈਵ ਸਰਵਰ ਵਰਤੋ
+# ਇੰਡੈਕਸ.html ਨੂੰ ਬ੍ਰਾਊਜ਼ਰ ਵਿੱਚ ਖੋਲ੍ਹੋ ਜਾਂ ਲਾਈਵ ਸਰਵਰ ਵਰਤੋਂ
 ```
-### Chat ਪ੍ਰੋਜੈਕਟ (Python ਬੈਕਐਂਡ)
+### ਚੈਟ ਪ੍ਰੋਜੈਕਟ (Python ਬੈਕਏਂਡ)
 ```bash
 cd 9-chat-project/solution/backend/python
 pip install openai
-# GITHUB_TOKEN ਵਾਤਾਵਰਣ ਚਰ ਨੂੰ ਸੈੱਟ ਕਰੋ
+# GITHUB_TOKEN ਵਾਤਾਵਰਣ ਚਲ ਬਦਲੋ ਸੈਟ ਕਰੋ
 python api.py
 ```
-## ਵਿਕਾਸ ਦਾ ਕੰਮ ਕਰਨ ਦਾ ਤਰੀਕਾ
+## ਵਿਕਾਸ ਵਰਕਫਲੋ
-### ਸਮੱਗਰੀ ਯੋਗਦਾਨਕਰਤਾਵਾਂ ਲਈ
+### ਸਮੱਗਰੀ ਯੋਗਦਾਨਕਾਰਾਂ ਲਈ
-1. ਆਪਣੇ GitHub ਖਾਤੇ ਵਿੱਚ ਰਿਪੋਜ਼ਿਟਰੀ ਨੂੰ ਫੋਰਕ ਕਰੋ
+1. ਆਪਣਾ GitHub ਖਾਤਾ ਵਿੱਚ ਰਿਪੋਜ਼ਿਟਰੀ ਨੂੰ ਫੌਰਕ ਕਰੋ
-2. ਆਪਣੇ ਫੋਰਕ ਨੂੰ ਸਥਾਨਕ ਕਲੋਨ ਕਰੋ
+2. ਲੋ컬ੀ ਆਪਣੇ ਫੌਰਕ ਨੂੰ ਕਲੋਨ ਕਰੋ
-3. ਆਪਣੀਆਂ ਬਦਲਾਵਾਂ ਲਈ ਨਵਾਂ ਬ੍ਰਾਂਚ ਬਣਾਓ
+3. ਆਪਣੇ ਬਦਲਾਅ ਲਈ ਨਵੀਂ ਬ੍ਰਾਂਚ ਬਣਾਓ
-4. ਪਾਠ ਸਮੱਗਰੀ ਜਾਂ ਕੋਡ ਉਦਾਹਰਣਾਂ ਵਿੱਚ ਬਦਲਾਵ ਕਰੋ
+4. ਪਾਠ ਸਮੱਗਰੀ ਜਾਂ ਕੋਡ ਉਦਾਹਰਣਾਂ ਵਿੱਚ ਬਦਲਾਅ ਕਰੋ
-5. ਸੰਬੰਧਿਤ ਪ੍ਰੋਜੈਕਟ ਡਾਇਰੈਕਟਰੀਜ਼ ਵਿੱਚ ਕੋਡ ਨੂੰ ਟੈਸਟ ਕਰੋ
+5. ਸੰਬੰਧਿਤ ਪ੍ਰੋਜੈਕਟ ਡਾਇਰੈਕਟਰੀਆਂ ਵਿੱਚ ਕੋਡ ਬਦਲਾਅ ਦੀ ਜਾਂਚ ਕਰੋ
-6. ਯੋਗਦਾਨ ਸਬੰਧੀ ਦਿਸ਼ਾ-ਨਿਰਦੇਸ਼ਾਂ ਅਨੁਸਾਰ ਪੁਲ ਰਿਕਵੈਸਟ ਭੇਜੋ
+6. ਯੋਗਦਾਨ ਦਿਓ ਧਿਆਨ ਦਿੰਦੇ ਹੋਏ ਪੂਲ ਰਿਕਵੇਸਟ ਸਬਮਿਟ ਕਰੋਂ
 ### ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ
-1. ਰਿਪੋਜ਼ਿਟਰੀ ਨੂੰ ਫੋਰਕ ਜਾਂ ਕਲੋਨ ਕਰੋ
+1. ਰਿਪੋਜ਼ਿਟਰੀ ਨੂੰ ਫੌਰਕ ਜਾਂ ਕਲੋਨ ਕਰੋ
-2. ਲਗਾਤਾਰ ਪਾਠ ਡਾਇਰੈਕਟਰੀਆਂ ਵਿੱਚ ਜਾਓ
+2. ਲੈਸਨ ਡਾਇਰੈਕਟਰੀਆਂ ਵਿੱਚ ਕ੍ਰਮਵਾਰ ਜਾਓ
-3. ਹਰ ਪਾਠ ਲਈ README ਫਾਈਲਾਂ ਪੜ੍ਹੋ
+3. ਹਰ ਪਾਠ ਲਈ README ਫਾਇਲਾਂ ਪੜ੍ਹੋ
-4. ਪ੍ਰੀ-ਪਾਠ ਕੁਇਜ਼ https://ff-quizzes.netlify.app/web/ ਤੇ ਪੂਰੇ ਕਰੋ
+4. ਪਹਿਲਾਂ ਲੈਸਨ ਬਣਾਉਣ ਵਾਲੇ ਕਵਿਜ਼ ਨੂੰ https://ff-quizzes.netlify.app/web/ ਤੇ ਪੂਰਾ ਕਰੋ
 5. ਪਾਠ ਫੋਲਡਰਾਂ ਵਿੱਚ ਕੋਡ ਉਦਾਹਰਣਾਂ 'ਤੇ ਕੰਮ ਕਰੋ
-6. ਅਸਾਈਨਮੈਂਟ ਅਤੇ ਚੈਲੈਂਜ ਪੂਰੇ ਕਰੋ
+6. ਅਸਾਇਨਮੈਂਟ ਅਤੇ ਚੈਲੇਂਜ ਪੂਰੇ ਕਰੋ
-7. ਪੋਸਟ-ਪਾਠ ਕੁਇਜ਼ ਲਓ
+7. ਬਾਅਦ ਦੇ ਲੈਸਨ ਕਵਿਜ਼ ਲਵੋ
 ### ਲਾਈਵ ਵਿਕਾਸ
 - **ਦਸਤਾਵੇਜ਼**: ਰੂਟ ਵਿੱਚ `docsify serve` ਚਲਾਓ (ਪੋਰਟ 3000)
- **ਕੁਇਜ਼ ਐਪ**: quiz-app ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ `npm run dev` ਚਲਾਓ
+- **ਕਵਿਜ਼ ਐਪ**: `quiz-app` ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ `npm run dev` ਚਲਾਓ
- **ਪ੍ਰੋਜੈਕਟ**: VS Code Live Server ਐਕਸਟੇਸ਼ਨ ਵਲੋਂ HTML ਪ੍ਰੋਜੈਕਟ ਚਲਾਓ
+- **ਪ੍ਰੋਜੈਕਟਾਂ**: HTML ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ VS Code Live Server ਐਕਸਟੈਂਸ਼ਨ ਵਰਤੋਂ
- **API ਪ੍ਰੋਜੈਕਟ**: ਸੰਬੰਧਿਤ API ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ `npm start` ਚਲਾਓ
+- **API ਪ੍ਰੋਜੈਕਟ**: ਸੰਬੰਧਿਤ API ਡਾਇਰੈਕਟਰੀਆਂ ਵਿੱਚ `npm start` ਚਲਾਓ
-## ਟੈਸਟਿੰਗ ਦਿਸ਼ਾ-ਨਿਰਦੇਸ਼
+## ਟੈਸਟਿੰਗ ਨਿਰਦੇਸ਼
-### Quiz ਐਪ ਟੈਸਟਿੰਗ
+### ਕਵਿਜ਼ ਐਪ ਟੈਸਟਿੰਗ
 ```bash
 cd quiz-app
-npm run lint       # ਕੋਡ ਸ਼ੈਲੀ ਦੇ ਮੁੱਦਿਆਂ ਦੀ ਜਾਂچ ਕਰੋ
+npm run lint       # ਕੋਡ ਸਟਾਈਲ ਸਮੱਸਿਆਵਾਂ ਲਈ ਜਾਂਚ ਕਰੋ
-npm run build      # ਬਣਾਉਂਡ ਦੁਆਰਾ ਸਫਲ ਹੋਣ ਦੀ ਜਾਂਚ ਕਰੋ
+npm run build      # ਨਿਰਮਾਣ ਸਫਲ ਹੋਣਾ ਪੁਸ਼ਟੀ ਕਰੋ
 ```
 ### ਬੈਂਕ API ਟੈਸਟਿੰਗ
 ```bash
 cd 7-bank-project/api
-npm run lint       # ਕੋਡ ਸਟਾਈਲ ਸਮੱਸਿਆਵਾਂ ਦੀ ਜਾਂਚ ਕਰੋ
+npm run lint       # ਕੋਡ ਅੰਦਾਜ਼ ਸਮੱਸਿਆਵਾਂ ਦੀ ਜਾਂਚ ਕਰੋ
-node server.js     # ਸਰਵਰ ਬਿਨਾ ਗਲਤੀਆਂ ਦੇ ਸ਼ੁਰੂ ਹੁੰਦਾ ਹੈ ਜਾਂ ਨਹੀਂ ਜਾਂਚੋ
+node server.js     # ਬਿਨਾਂ ਗਲਤੀਆਂ ਦੇ ਸਰਵਰ ਸ਼ੁਰੂ ਹੋਣ ਦੀ ਜਾਂਚ ਕਰੋ
 ```
-### ਆਮ ਟੈਸਟਿੰਗ ਪদ্ধਤੀ
+### ਆਮ ਟੈਸਟਿੰਗ ਪਹੁੰਚ
- ਇਹ ਇੱਕ ਸਿੱਖਿਆ ਰਿਪੋਜ਼ਿਟਰੀ ਹੈ ਜਿਸ ਵਿੱਚ ਵਿਆਪਕ ਆਟੋਮੇਟੇਡ ਟੈਸਟ ਨਹੀਂ ਹਨ
+- ਇਹ ਇੱਕ ਸਿੱਖਣਯੋਗ ਰਿਪੋਜ਼ਿਟਰੀ ਹੈ ਜਿਸ ਵਿੱਚ ਪੂਰਨ ਆਟੋਮੈਟਿਕ ਟੈਸਟ ਨਹੀਂ ਹਨ
- ਮੈਨੂਅਲ ਟੈਸਟਿੰਗ ਧਿਆਨ ਦੇਂਦਾ ਹੈ:
+- ਮੈਨੁਅਲ ਟੈਸਟਿੰਗ ‘ਤੇ ਧਿਆਨ:
-  - ਕੋਡ ਉਦਾਹਰਣਾਂ ਨੂੰ ਬਿਨਾ ਗਲਤੀ ਚਲਾਉਣਾ
+  - ਕੋਡ ਉਦਾਹਰਣਾਂ ਬਿਨਾਂ ਗਲਤੀਆਂ ਚੱਲ ਰਹੇ ਹੋਣ
-  - ਦਸਤਾਵੇਜ਼ ਵਿੱਚ ਲਿੰਕ ਸਹੀ ਕੰਮ ਕਰਦੇ ਹੋਣ
+  - ਦਸਤਾਵੇਜ਼ਾਂ ਵਿੱਚ ਲਿੰਕ ਠੀਕ ਕੰਮ ਕਰ ਰਹੇ ਹੋਣ
-  - ਪ੍ਰੋਜੈਕਟ ਸਹੀ ਖ਼ਤਮ ਹੋਣ
+  - ਪ੍ਰੋਜੈਕਟ ਬਿਲਡ ਸਫਲਤਾਪੂਰਵਕ ਹੋਣ
-  - ਉਦਾਹਰਣ ਵਧੀਆ ਤਰੀਕੇ ਦੀ ਪਾਲਣਾ ਕਰਦੇ ਹੋਣ
+  - ਉਦਾਹਰਣਾਂ ਵਧੀਆ ਪ੍ਰਥਾਵਾਂ ਦੀ ਪਾਲਣਾ ਕਰ ਰਹੇ ਹੋਣ
-### ਪਰੇ-ਸਬਮਿਸ਼ਨ ਚੈਕਸ
+### ਪੂਰਵ-ਦਾਖਲਾ ਚੈੱਕ
- ਜਿਨ੍ਹਾਂ ਡਾਇਰੈਕਟਰੀਜ਼ ਵਿੱਚ package.json ਹੈ ਉਥੇ `npm run lint` ਚਲਾਓ
+- `package.json` ਵਾਲੇ ਫੋਲਡਰਾਂ ਵਿੱਚ `npm run lint` ਚਲਾਓ
- ਮਾਰਕਡਾਊਨ ਲਿੰਕਾਂ ਨੂੰ ਸਹੀ ਪਰਖੋ
+- ਮਾਰਕਡਾਊਨ ਲਿੰਕਾਂ ਦੀ ਸੰਪੂਰਨਤਾ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ
- ਕੋਡ ਉਦਾਹਰਣਾਂ ਨੂੰ ਬਰਾਊਜ਼ਰ ਜਾਂ Node.js ਵਿੱਚ ਟੈਸਟ ਕਰੋ
+- ਕੋਡ ਉਦਾਹਰਣ ਬ੍ਰਾਉਜ਼ਰ ਜਾਂ Node.js ਵਿੱਚ ਟੈਸਟ ਕਰੋ
- ਅਨੁਵਾਦ ਸੰਰਚਨਾ ਨੂੰ ਠੀਕ ਰੱਖਣ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ
+- ਅਨੁਵਾਦਾਂ ਦੀ ਸਠਿਕ ਰਚਨਾ ਬਰਕਰਾਰ ਰਹਿੰਦੀ ਹੈ ਜਾਂ ਨਹੀਂ ਚੈੱਕ ਕਰੋ
-## ਕੋਡ ਸਟਾਈਲ ਦਿਸ਼ਾ-ਨਿਰਦੇਸ਼
+## ਕੋਡ ਸਟਾਈਲ ਨਿਰਦੇਸ਼
-### ਜਾਵਾਸਕ੍ਰਿਪਟ
+### JavaScript
- ਆਧੁਨਿਕ ES6+ ਸਿੰਟੈਕਸ ਵਰਤੋਂ
+- ਆਧੁਨਿਕ ES6+ ਵਾਕਯਾਂ ਨੂੰ ਵਰਤੋਂ
- ਪ੍ਰੋਜੈਕਟਾਂ ਵਿੱਚ ਦਿੱਤੇ ESLint ਨਿਯਮਾਂ ਦੀ ਪਾਲਣਾ ਕਰੋ
+- ਪ੍ਰਾਜੈਕਟਾਂ ਵਿੱਚ ਦਿੱਤੇ ਗਏ ESLint ਵਿਵਸਥਾਪਨ ਦੀ ਪਾਲਣਾ ਕਰੋ
- ਸਿੱਖਿਆ ਦੀ ਸਪਸ਼ਟਤਾ ਲਈ ਵਿਆਖਿਆਤਮਕ ਵੇਰੀਅਬਲ ਅਤੇ ਫੰਕਸ਼ਨ ਨਾਂ ਵਰਤੋ
+- ਸਿੱਖਣ ਦੀ ਸਪਸ਼ਟਤਾ ਲਈ ਮਾਇਨੇਵਾਲੇ ਵੈਰੀਅਬਲ ਅਤੇ ਫੰਕਸ਼ਨ ਨਾਮ ਵਰਤੋਂ
- ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ ਟਿੱਪਣੀਆਂ ਜੋੜੋ
+- ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ ਧਾਰਨਾ ਸਮਝਾਉਣ ਵਾਲੇ ਟਿੱਪਣੀਆਂ ਜੋੜੋ
- ਜਿੱਥੇ ਤੇਜ਼ੀ ਨਾਲ ਹੱਲ ਕਰਨ ਵਾਲੇ ਪ੍ਰੀਟੀਅਰ ਵਰਤੋ
+- ਜਿੱਥੇ ਲਾਗੂ ਹੋਵੇ ਪ੍ਰੀਟੀਅਰ ਨਾਲ ਫਾਰਮੈਟ ਕਰੋ
 ### HTML/CSS
- ਸੈਂਟੀਮੈਟਿਕ HTML5 ਇਲੈਮੈਂਟ
+- ਸਮਾਂਤਾਰਕ HTML5 ਤੱਤ
- ਰਿਸਪਾਂਸਿਵ ਡਿਜ਼ਾਈਨ ਸਿਧਾਂਤ
+- ਰਿਸਪਾਂਸਿਵ ਡਿਜ਼ਾਇਨ ਨੀਤੀ
- ਸਾਫ਼ ਸੰਗਠਿਤ ਕਲਾਸ ਨਾਂ
+- ਸਾਫ਼ ਸਿੱਧੇ ਕਲਾਸ ਨਾਂਮ
- CSS ਤਕਨੀਕਾਂ ਲਈ ਟਿੱਪਣੀਆਂ ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ
+- CSS ਤਕਨੀਕਾਂ ਸਿੱਖਾਉਂਦੀਆਂ ਟਿੱਪਣੀਆਂ
-### ਪਾਇਥਨ
+### Python
- PEP 8 ਸਟਾਈਲ ਦਿਸ਼ਾ-ਨਿਰਦੇਸ਼
+- PEP 8 ਸਟਾਈਲ ਧਾਰਾਵਾਂ
- ਸਪਸ਼ਟ ਅਤੇ ਸਿੱਖਣ ਜੋਗੇ ਕੋਡ ਉਦਾਹਰਣ
+- ਸਿੱਖਣ ਲਈ ਸਾਫ਼ ਕੋਡ ਉਦਾਹਰਣ
- ਸਿੱਖਣ ਲਈ ਟਾਈਪ ਹਿੰਟ ਜਿੱਥੇ ਲੋੜ ਹੋਵੇ
+- ਜਿੱਥੇ ਲਾਗੂ ਹੋਵੇ ਟਾਈਪ ਉਹ ਘੁੱਟਨ ਸਮੇਤ
-### ਮਾਰਕਡਾਊਨ ਦਸਤਾਵੇਜ਼ੀ
+### ਮਾਰਕਡਾਊਨ ਦਸਤਾਵੇਜ਼
- ਸਪਸ਼ਟ ਹੈਡਿੰਗ ਹਾਇਰਾਰਕੀ
+- ਸਪਸ਼ਟ ਸਿਰਲੇਖਾਂ ਦੀ ਵਰਕਿਰਤਾ
- ਭਾਸ਼ਾ ਨਿਰਧਾਰਿਤ ਕੋਡ ਬਲਾਕ
+- ਭਾਸ਼ਾ ਨਾਲ ਕੋਡ ਬਲਾਕ
- ਵਾਧੂ ਸਾਧਨਾਂ ਲਈ ਲਿੰਕ
+- ਵਾਧੂ ਸਰੋਤਾਂ ਲਈ ਲਿੰਕ
- `images/` ਫੋਲਡਰ ਵਿੱਚ ਸਕ੍ਰੀਨਸ਼ੌਟ ਅਤੇ ਚਿੱਤਰ
+- `images/` ਫੋਲਡਰਾਂ ਵਿੱਚ ਸਕ੍ਰੀਨਸ਼ਾਟ ਅਤੇ ਚਿੱਤਰ
 - ਪਹੁੰਚਯੋਗਤਾ ਲਈ ਚਿੱਤਰਾਂ ਦਾ Alt ਟੈਕਸਟ
-### ਫਾਈਲ ਸੰਗਠਨ
+### ਫਾਇਲ ਸੰਗਠਨ
- ਪਾਠਾਂ ਨੂੰ ਲਗਾਤਾਰ ਨੰਬਰ ਦਿੱਤਾ ਗਿਆ (1-getting-started-lessons, 2-js-basics, ਆਦਿ)
+- ਲੈਸਨ ਕ੍ਰਮਵਾਰ ਨੰਬਰਿਤ (1-getting-started-lessons, 2-js-basics, ਆਦਿ)
- ਹਰ ਪ੍ਰੋਜੈਕਟ ਵਿੱਚ `solution/` ਅਤੇ ਅਕਸਰ `start/` ਜਾਂ `your-work/` ਡਾਇਰੈਕਟਰੀਜ਼
+- ਹਰ ਪ੍ਰੋਜੈਕਟ ਵਿੱਚ `solution/` ਅਤੇ ਅਕਸਰ `start/` ਜਾਂ `your-work/` ਡਾਇਰੈਕਟਰੀਆਂ
- ਪਾਠ ਅਨੁਸਾਰ `images/` ਫੋਲਡਰਾਂ ਵਿੱਚ ਚਿੱਤਰ ਸਟੋਰ
+- ਪਾਠ-ਵਿਸ਼ੇਸ਼ `images/` ਫੋਲਡਰਾਂ ਵਿੱਚ ਚਿੱਤਰ ਸਟੋਰ ਹੁੰਦੇ ਹਨ
- ਅਨੁਵਾਦ `translations/{language-code}/` ਬਣਤਰ ਵਿੱਚ
+- ਤਰਜਮੇ ਨੂੰ `translations/{language-code}/` ਵਿੱਚ ਸੰਗ੍ਰਹਿਤ ਕਰਨਾ
-## ਬਣਾਉ ਅਤੇ ਤैनਾਤੀ
+## ਬਿਲਡ ਅਤੇ ਡਿਪਲੋਇਮੈਂਟ
-### Quiz ਐਪ ਤੈਨਾਤੀ (Azure Static Web Apps)
+### ਕਵਿਜ਼ ਐਪ ਡਿਪਲੋਇਮੈਂਟ (Azure Static Web Apps)
-quiz-app ਨੂੰ Azure Static Web Apps ਲਈ ਤਾਇਨਾਤ ਕੀਤਾ ਗਿਆ ਹੈ:
+quiz-app ਨੂੰ Azure Static Web Apps ਡਿਪਲੋਇਮੈਂਟ ਲਈ ਸੈਟ ਕੀਤਾ ਗਿਆ ਹੈ:
 ```bash
 cd quiz-app
 npm run build      # dist/ ਫੋਲਡਰ ਬਣਾਉਂਦਾ ਹੈ
-# ਮੂਲ ‘ਤੇ ਧੱਕਣ ‘ਤੇ GitHub Actions ਵਰਕਫਲੋ ਰਾਹੀਂ ਤਾਇਨਾਤ ਕਰਦਾ ਹੈ
+# ਮੈਨ branch 'ਤੇ push ਕਰਨ 'ਤੇ GitHub Actions ਵਰਕਫਲੋ ਰਾਹੀਂ ਡਿਪਲੌਏਂਡ ਕਰਦਾ ਹੈ
 ```
 Azure Static Web Apps ਸੰਰਚਨਾ:
- **ਐਪ ਸਥਾਨ**: `/quiz-app`
+- **ਐਪ ਸਥਿਤੀ**: `/quiz-app`
- **ਆਉਟਪੁੱਟ ਸਥਾਨ**: `dist`
+- **ਆਉਟਪੁੱਟ ਸਥਿਤੀ**: `dist`
 - **ਵਰਕਫਲੋ**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
-### ਦਸਤਾਵੇਜ਼ PDF ਬਣਾਉ
+### ਦਸਤਾਵੇਜ਼ PDF ਬਣਾਉਣਾ
 ```bash
 npm install                    # docsify-to-pdf ਨੂੰ ਇੰਸਟਾਲ ਕਰੋ
-npm run convert               # docs ਤੋਂ PDF ਤਿਆਰ ਕਰੋ
+npm run convert               # docs ਤੋਂ PDF ਬਣਾਓ
 ```
-### Docsify ਦਸਤਾਵੇਜ਼ੀ
+### Docsify ਦਸਤਾਵੇਜ਼
 ```bash
-npm install -g docsify-cli    # ਡੋਕਸਿਫਾਈ ਨੂੰ ਗਲੋਬਲ ਤੌਰ 'ਤੇ ਇੰਸਟਾਲ ਕਰੋ
+npm install -g docsify-cli    # ਡੌਕਸੀਫਾਈ ਨੂੰ ਗਲੋਬਲੀ ਇੰਸਟਾਲ ਕਰੋ
-docsify serve                 # ਲੋਕਲਹੁਸਟ:3000 'ਤੇ ਸਰਵ ਕਰੋ
+docsify serve                 # ਲੋਕਲਹੋਸਟ:3000 'ਤੇ ਸਰਵ ਕਰੋ
 ```
-### ਪ੍ਰੋਜੈਕਟ-ਵਿਸ਼ੇਸ਼ ਬਣਾਉ
+### ਪ੍ਰੋਜੈਕਟ-ਵਿਸ਼ੇਸ਼ ਬਿਲਡ
-ਹਰ ਪ੍ਰੋਜੈਕਟ ਡਾਇਰੈਕਟਰੀ ਦਾ ਆਪਣਾ ਬਣਾਉ ਪ੍ਰਕਿਰਿਆ ਹੋ ਸਕਦੀ ਹੈ:
+ਹਰ ਪ੍ਰੋਜੈਕਟ ਡਾਇਰੈਕਟਰੀ ਦਾ ਆਪਣਾ ਬਿਲਡ ਪ੍ਰਕਿਰਿਆ ਹੋ ਸਕਦਾ ਹੈ:
- Vue ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ: `npm run build` ਪ੍ਰੋਡਕਸ਼ਨ ਬੰਡਲ ਬਣਾਉਂਦਾ ਹੈ
+- Vue ਪ੍ਰੋਜੈਕਟ: `npm run build` ਨਾਲ ਉਤਪਾਦਨ ਬੰਨਲ ਬਣਾਓ
- ਸਥਿਰ ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ: ਕੋਈ ਬਣਾਉ ਕਦਮ ਨਹੀਂ, ਫਾਈਲਾਂ ਸਿੱਧਾ ਸਰਵ ਕਰੋ
+- ਸਟੈਟਿਕ ਪ੍ਰੋਜੈਕਟ: ਕੋਈ ਬਿਲਡ ਨਹੀਂ, ਸਿੱਧੇ ਫਾਇਲਾਂ ਸੇਵਾ ਕਰੋ
-## ਪੁਲ ਰਿਕਵੈਸਟ ਦਿਸ਼ਾ-ਨਿਰਦੇਸ਼
+## ਪੂਲ ਰਿਕਵੇਸਟ ਨਿਯਮ
 ### ਸਿਰਲੇਖ ਫਾਰਮੈਟ
-ਸੁਝਾਅ ਬਦਲਾਅ ਦੇ ਹਿੱਸੇ ਸਪਸ਼ਟ ਤੌਰ 'ਤੇ ਦਰਸਾਉਣ ਵਾਲੇ ਸਿਰਲੇਖ ਵਰਤੋ:
+ਸਪਸ਼ਟ, ਵਰਣਨਾਤਮਕ ਸਿਰਲੇਖ ਜੋ ਬਦਲਾਅ ਦੇ ਖੇਤਰ ਨੂੰ ਦਰਸਾਉਂਦੇ ਹਨ:
 - `[Quiz-app] Add new quiz for lesson X`
 - `[Lesson-3] Fix typo in terrarium project`
 - `[Translation] Add Spanish translation for lesson 5`
 - `[Docs] Update setup instructions`
-### ਜ਼ਰੂਰੀ ਚੈੱਕ
+### ਲੋੜੀਂਦੇ ਚੈੱਕਸ
-ਪੁਲ ਰਿਕਵੈਸਟ ਭੇਜਣ ਤੋਂ ਪਹਿਲਾਂ:
+ਪੂਲ ਰਿਕਵੇਸਟ ਭੇਜਣ ਤੋਂ ਪਹਿਲਾਂ:
 1. **ਕੋਡ ਕੁਆਲਿਟੀ**:
-   - ਪ੍ਰਭਾਵਿਤ ਪ੍ਰੋਜੈਕਟ ਡਾਇਰੈਕਟਰੀਜ਼ ਵਿੱਚ `npm run lint` ਚਲਾਓ
+   - ਪ੍ਰਭਾਵਿਤ ਪ੍ਰੋਜੈਕਟ ਡਾਇਰੈਕਟਰੀਆਂ ਵਿੱਚ `npm run lint` ਚਲਾਓ
-   - ਸਾਰੇ ਕਮੀਆਂ ਅਤੇ ਚੇਤਾਵਨੀ ਸੁਧਾਰੋ
+   - ਸਾਰੇ ਲਿੰਟ ਗਲਤੀਆਂ ਅਤੇ ਚੇਤਾਵਨੀ ਦੂਰ ਕਰੋ
-2. **ਬਿਲਡ ਚੈਕ**:
+2. **ਬਿਲਡ ਪੁਸ਼ਟੀ**:
   - ਜੇ ਲਾਗੂ ਹੋਵੇ ਤਾਂ `npm run build` ਚਲਾਓ
-   - ਕੋਈ ਬਣਾਉ ਗਲਤੀ ਨਾ ਹੋਵੇ
+   - ਕੋਈ ਬਿਲਡ ਗਲਤੀ ਨਹੀਂ ਹੋਣ
-3. **ਲਿੰਕ ਦਾ ਪਰਖ**:
+3. **ਲਿੰਕ ਵੈਧਤਾ**:
-   - ਸਾਰੇ ਮਾਰਕਡਾਊਨ ਲਿੰਕਾਂ ਟੈਸਟ ਕਰੋ
+   - ਸਾਰੇ ਮਾਰਕਡਾਊਨ ਲਿੰਕ ਟੈਸਟ ਕਰੋ
-   - ਚਿੱਤਰ ਦੇ ਸੰਦਰਭ ਸਹੀ ਹੋਣ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ
+   - ਚਿੱਤਰ ਸੰਦਰਭਾਂ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ
 4. **ਸਮੱਗਰੀ ਸਮੀਖਿਆ**:
-   - ਵਰਣਮਾਲਾ ਅਤੇ ਵਿਆਕਰਨ ਸਹੀ ਹੈ ਕੀ ਨਹੀਂ ਪੜ੍ਹੋ
+   - ਸਪੈਲਿੰਗ ਅਤੇ ਵਿਆਕਰਨ ਲਈ ਪ੍ਰੂਫਰੀਡ ਕਰੋ
-   - ਕੋਡ ਉਦਾਹਰਣ ਸਹੀ ਅਤੇ ਸਿੱਖਣ ਯੋਗ ਹਨ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ
+   - ਕੋਡ ਉਦਾਹਰਣ ਸਹੀ ਅਤੇ ਸਿੱਖਣਯੋਗ ਹੋਣ
-   - ਅਨੁਵਾਦ ਅਸਲੀ ਮਹੱਤਵ ਬਣਾਈ ਰੱਖਦੇ ਹਨ
+   - ਅਨੁਵਾਦਾਂ ਦਾ ਮੂਲ ਅਰਥ ਬਣਿਆ ਰਹੇ ਇਹ ਚੈੱਕ ਕਰੋ
-### ਯੋਗਦਾਨ ਦੇ ਅਹੁਦੇ
+### ਯੋਗਦਾਨ ਲੈਣ ਦੀਆਂ ਸ਼ਰਤਾਂ
- Microsoft CLA ਨਾਲ ਸਹਿਮਤ ਹੋਵੋ (ਪਹਿਲੀ PR ਲਈ ਆਟੋਚੈਕ)
+- ਮਾਈਕ੍ਰੋਸਾਫਟ CLA (ਸਵੈਚਾਲਿਤ ਜਾਂਚ ਪਹਿਲੀ PR ‘ਤੇ) ਨੂੰ ਮਨਜ਼ੂਰ ਕਰੋ
- [Microsoft Open Source ਕੋਡ ਆਫ਼ ਕੰਡੱਕਟ](https://opensource.microsoft.com/codeofconduct/) ਦੀ ਪਾਲਣਾ ਕਰੋ
+- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) ਦੀ ਪਾਲਣਾ ਕਰੋ
 - ਵਿਸਥਾਰ ਲਈ [CONTRIBUTING.md](./CONTRIBUTING.md) ਵੇਖੋ
- ਜੇ ਲਾਗੂ ਹੋਵੇ ਤਾਂ ਪੁਲ ਰਿਕਵੈਸਟ ਵੇਰਵੇ ਵਿੱਚ ਮੁਦਦਾ ਨੰਬਰ ਦਰਜ ਕਰੋ
+- ਜੇ ਲਾਗੂ ਹੋਵੇ ਤਾਂ PR ਵੇਰਵੇ ਵਿੱਚ ਮੁੱਦੇ ਨੰਬਰ ਦਰਜ ਕਰੋ
 ### ਸਮੀਖਿਆ ਪ੍ਰਕਿਰਿਆ
- ਪੁਲ ਰਿਕਵੈਸਟ ਨੂੰ ਸੁਚਾਲਕ ਅਤੇ ਕਮਿਊਨਿਟੀ ਦੁਆਰਾ ਸਮੀਖਿਆ ਕੀਤਾ ਜਾਵੇਗਾ
+- PRs ਨੂੰ ਮੇਂਟੇਨਰਾਂ ਅਤੇ ਕਮਿਊਨਿਟੀ ਵੱਲੋਂ ਸਮੀਖਿਆ ਕੀਤੀ ਜਾਂਦੀ ਹੈ
- ਸਿੱਖਿਆ ਸਪਸ਼ਟਤਾ ਨੂੰ ਪਹਿਲ ਦਿੱਤੀ ਜਾਵੇਗੀ
+- ਸਿੱਖਣਯੋਗ ਸਪਸ਼ਟਤਾ ਪ੍ਰਾਥਮਿਕਤਾ ਹੈ
- ਕੋਡ ਉਦਾਹਰਣ ਨੂੰ ਵਰਤਮਾਨ ਵਧੀਆ ਤਰੀਕੇ ਅਨੁਸਾਰ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ
+- ਕੋਡ ਉਦਾਹਰਣ ਮੌਜੂਦਾ ਵਧੀਆ ਅਭਿਆਸਾਂ ਦੀ ਪਾਲਣਾ ਕਰਨੇ ਚਾਹੀਦੇ ਹਨ
- ਅਨੁਵਾਦ ਨੂੰ ਯਥਾਰਥ ਅਤੇ ਸੱਭਿਆਚਾਰਕ ਤੌਰ 'ਤੇ ਜ਼ਾਂਚਿਆ ਜਾਵੇਗਾ
+- ਅਨੁਵਾਦਾਂ ਦੀ ਸੁਨਿਸ਼ਚਿਤਤਾ ਅਤੇ ਸਾਂਸਕ੍ਰਿਤਿਕ ਉਚਿਤਤਾ ਲਈ ਸਮੀਖਿਆ
-## ਅਨੁਵਾਦ ਪ੍ਰਣਾਲੀ
+## ਅਨੁਵਾਦ ਸਿਸਟਮ
-### ਆਟੋਮੇਟੇਡ ਅਨੁਵਾਦ
+### ਸਵੈਚਾਲਿਤ ਅਨੁਵਾਦ
- GitHub Actions ਵਿੱਚ co-op-translator ਵਰਕਫਲੋ ਵਾਪਰਦਾ ਹੈ
+- GitHub Actions ਨਾਲ co-op-translator ਵਰਕਫਲੋ ਵਰਤਦਾ ਹੈ
- 50+ ਭਾਸ਼ਾਵਾਂ ਵਿੱਚ ਆਪਣੇ ਆਪ ਅਨੁਵਾਦ ਕਰਦਾ ਹੈ
+- 50+ ਭਾਸ਼ਾਵਾਂ ਵਿੱਚ ਸਵੈਚਾਲਿਤ ਤੌਰ 'ਤੇ ਅਨੁਵਾਦ ਕਰਦਾ ਹੈ
- ਮੂਲ ਫਾਈਲਾਂ ਮੁੱਖ ਡਾਇਰੈਕਟਰੀਜ਼ ਵਿੱਚ ਹਨ
+- ਸੋ스 ਫਾਇਲਾਂ ਮੁੱਖ ਡਾਇਰੈਕਟਰੀਆਂ ਵਿੱਚ ਹਨ
- ਅਨੁਵਾਦਿਤ ਫਾਈਲਾਂ `translations/{language-code}/` ਵਿੱਚ ਹਨ
+- ਅਨੁਵਾਦ ਕੀਤੀਆਂ ਫਾਇਲਾਂ `translations/{language-code}/` ਵਿੱਚ ਹਨ
-### ਮੈਨੂਅਲ ਅਨੁਵਾਦ ਸੁਧਾਰ ਜੋੜਨਾ
+### ਮੈਨੁਅਲ ਅਨੁਵਾਦ ਸੁਧਾਰ ਜੋੜਨਾ
-1. `translations/{language-code}/` ਵਿੱਚ ਫਾਈਲ ਲੱਭੋ
+1. `translations/{language-code}/` ਵਿੱਚ ਫਾਇਲ ਲੱਭੋ
-2. ਸੰਰਚਨਾ ਬਿਨਾ ਬਦਲੇ ਸੁਧਾਰ ਕਰੋ
+2. ਸੰਰਚਨਾ ਨੂੰ ਸੁਰੱਖਿਅਤ ਰੱਖਦਿਆਂ ਸੁਧਾਰ ਕਰੋ
-3. ਕੋਡ ਉਦਾਹਰਣਾਂ ਨੂੰ ਫੰਕਸ਼ਨਲ ਰੱਖੋ
+3. ਕੋਡ ਉਦਾਹਰਣ ਕੰਮਕਾਜ਼ ਹੁੰਦੇ ਰਹਿੰਦੇ ਹਨ ਇਹ ਯਕੀਨੀ ਬਣਾਓ
-4. ਕਿਸੇ ਵੀ ਸਥਾਨਕ ਕੁਇਜ਼ ਸਮੱਗਰੀ ਨੂੰ ਟੈਸਟ ਕਰੋ
+4. ਕਿਸੇ ਵੀ ਸਥਾਨਕ ਕਵਿਜ਼ ਸਮੱਗਰੀ ਦੀ ਜਾਂਚ ਕਰੋ
-### ਅਨੁਵਾਦ ਮੇਟਾਡਾਟਾ
+### ਅਨੁਵਾਦ ਮੈਟਾ ਡੇਟਾ
-ਅਨੁਵਾਦਿਤ ਫਾਈਲਾਂ ਵਿੱਚ ਮੇਟਾਡਾਟਾ ਹੈਡਰ ਹੁੰਦਾ ਹੈ:
+ਅਨੁਵਾਦ ਕੀਤੀਆਂ ਫਾਇਲਾਂ metadata ਹੈੱਡਰ ਸ਼ਾਮਲ ਕਰਦੀਆਂ ਹਨ:
 ```markdown
 <!--
 CO_OP_TRANSLATOR_METADATA:
@ -289,120 +289,120 @@ CO_OP_TRANSLATOR_METADATA:
 -->
 ```
-## ਡੀਬੱਗਿੰਗ ਅਤੇ ਸਮੱਸਿਆ ਸਲਝਾਉਣਾ
+## ਡੀਬੱਗਿੰਗ ਅਤੇ ਸਮੱਸਿਆਵਾਂ ਦਾ ਨਿਵਾਰਣ
 ### ਆਮ ਸਮੱਸਿਆਵਾਂ
-**ਕੁਇਜ਼ ਐਪ ਸ਼ੁਰੂ ਨਹੀਂ ਹੁੰਦਾ**:
+**ਕਵਿਜ਼ ਐਪ ਸ਼ੁਰੂ ਨਹੀਂ ਹੁੰਦਾ**:
- Node.js ਵਰਜ਼ਨ (v14+ ਸਿਫਾਰਸ਼ੀ) ਚੈੱਕ ਕਰੋ
+- Node.js ਵਰਜਨ ਚੈੱਕ ਕਰੋ (v14+ ਸਿਫਾਰਸ਼ੀ ਹੈ)
 - `node_modules` ਅਤੇ `package-lock.json` ਮਿਟਾਓ, ਫਿਰ `npm install` ਚਲਾਓ
- ਪੋਰਟ ਟਕਰਾਅ ਦੇਖੋ (ਡਿਫਾਲਟ: Vite ਪੋਰਟ 5173 ਵਰਤਦਾ ਹੈ)
+- ਪੋਰਟ ਟਕਰਾਅ ਚੈੱਕ ਕਰੋ (ਮੂਲ: Vite 5173 ਪੋਰਟ ਵਰਤਦਾ ਹੈ)
-**API ਸਰਵਰ ਸ਼ੁਰੂ ਨਹੀਂ ਹੁੰਦਾ**:
+**API ਸਰਵਰ ਸ਼ੁਰੂ ਨਹੀਂ ਹੁੰਦਾ**:
- Node.js ਵਰਜ਼ਨ ਨਿਯਮਤ ਹੈ (node >=10)
+- Node.js ਵਰਜਨ ਨਿਰੀਖਣ ਕਰੋ (node >=10)
- ਪੋਰਟ ਵਰਤਿਆ ਜਾ ਰਿਹਾ ਹੈ ਜਾਂ ਨਹੀਂ ਵੇਖੋ
+- ਜੇ ਪੋਰਟ ਪਹਿਲਾਂ ਹੀ ਵਰਤਿਆ ਜਾ ਰਿਹਾ ਹੈ ਤਾਂ ਚੈੱਕ ਕਰੋ
- ਸਾਰੀਆਂ ਲਾਇਬ੍ਰੇਰੀਆਂ `npm install` ਨਾਲ ਇੰਸਟਾਲ ਹੋਈਆਂ ਹਨ
+- ਸਾਰੀਆਂ ਡਿਪੈਂਡੈਂਸੀਜ਼ `npm install` ਨਾਲ ਇੰਸਟਾਲ ਹੋਈਆਂ ਹਨ ਜਾਂ ਨਹੀਂ
-**ਬ੍ਰਾਉਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ ਲੋਡ ਨਹੀਂ ਹੁੰਦੀ**:
+**ਬਰਾਊਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ ਲੋਡ ਨਹੀਂ ਹੁੰਦਾ**:
- manifest.json ਸਹੀ ਫਾਰਮੈਟ ਹੈ ਜਾਂ ਨਹੀਂ ਚੈੱਕ ਕਰੋ
+- manifest.json ਢੰਗ ਨਾਲ ਫਾਰਮੈਟਡ ਹੈ ਜਾਂ ਨਹੀਂ ਜਾਂਚੋ
- ਬ੍ਰਾਉਜ਼ਰ ਕਨਸੋਲ ਦੀ ਗਲਤੀ ਦਿਖਾਈ ਦੇ ਰਹੀ ਹੈ ਜਾਂ ਨਹੀਂ ਵੇਖੋ
+- ਬਰਾਊਜ਼ਰ ਕਨਸੋਲ ਵਿੱਚ ਗਲਤੀਆਂ ਦੇਖੋ
- ਬ੍ਰਾਉਜ਼ਰ-ਵਿਸ਼ੇਸ਼ਤ ਐਕਸਟੈਂਸ਼ਨ ਸਥਾਪਨਾ ਹਦਾਇਤਾਂ ਦੀ ਪਾਲਣਾ ਕਰੋ
+- ਵਰਤੇ ਜਾ ਰਹੇ ਬਰਾਊਜ਼ਰ ਲਈ ਵਿਸ਼ੇਸ਼ ਐਕਸਟੈਂਸ਼ਨ ਇੰਸਟਾਲੇਸ਼ਨ ਅਨੁਸਾਰ ਕੰਮ ਕਰੋ
-**Python ਚੈਟ ਪ੍ਰੋਜੈਕਟ ਸਮੱਸਿਆ**:
+**Python ਚੈਟ ਪ੍ਰੋਜੈਕਟ ਸਮੱਸਿਆਵਾਂ**:
 - OpenAI ਪੈਕੇਜ ਇੰਸਟਾਲ ਕਰੋ: `pip install openai`
- GITHUB_TOKEN ਵਾਤਾਵਰਣ ਵੇਰੀਏਬਲ ਸੈਟ ਹੋਣਾ ਜ਼ਰੂਰੀ
+- GITHUB_TOKEN ਵਾਤਾਵਰਣ ਚਰ (environment variable) ਸੈੱਟ ਹੈ ਜਾਂ ਨਹੀਂ
- GitHub ਮਾਡਲਾਂ ਦੀ ਐਕਸੈਸ ਅਧਿਕਾਰ ਚੈੱਕ ਕਰੋ
+- GitHub ਮਾਡਲਜ਼ ਐਕਸੈਸ ਪਰਮਿਸ਼ਨਾਂ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ
-**Docsify ਦਸਤਾਵੇਜ਼ ਨਹੀਂ ਸਰਵ ਕਰਦਾ**:
+**Docsify ਦਸਤਾਵੇਜ਼ ਸੇਵਾ ਨਹੀਂ ਕਰ ਰਿਹਾ**:
- docsify-cli ਗਲੋਬਲਤੌਰ 'ਤੇ ਇੰਸਟਾਲ ਕਰੋ: `npm install -g docsify-cli`
+- docsify-cli ਗਲੋਬਲ ਇੰਸਟਾਲ ਕਰੋ: `npm install -g docsify-cli`
- ਰਿਪੋਜ਼ਿਟਰੀ ਦੇ ਰੂਟ ਤੋਂ ਚਲਾਓ
+- ਰਿਪੋਜ਼ਿਟਰੀ ਰੂਟ ਡਾਇਰੈਕਟਰੀ ਤੋਂ ਚਲਾਓ
- `docs/_sidebar.md` ਮੌਜੂਦ ਹੈ ਜਾਂ ਨਹੀਂ ਦੇਖੋ
+- `docs/_sidebar.md` ਮੌਜੂਦ ਹੈ ਜਾਂ ਨਹੀਂ ਜਾਂਚੋ
 ### ਵਿਕਾਸ ਵਾਤਾਵਰਣ ਟਿਪਸ
- HTML ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ VS Code ਨਾਲ Live Server ਐਕਸਟੈਂਸ਼ਨ ਵਰਤੋਂ
+- HTML ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ VS Code ਵਿੱਚ Live Server ਐਕਸਟੈਂਸ਼ਨ ਵਰਤੋਂ
- ESLint ਅਤੇ Prettier ਐਕਸਟੈਂਸ਼ਨਸ ਸਥਾਪਤ ਕਰੋ
+- ESLint ਅਤੇ Prettier ਐਕਸਟੈਂਸ਼ਨਾਂ ਨੂੰ ਅਨੁਕੂਲ ਫਾਰਮੈਟਿੰਗ ਲਈ ਇੰਸਟਾਲ ਕਰੋ
- ਜਾਵਾਸਕ੍ਰਿਪਟ ਡੀਬੱਗਿੰਗ ਲਈ ਬ੍ਰਾਉਜ਼ਰ DevTools ਵਰਤੋਂ
+- ਜਾਵਾਸਕ੍ਰਿਪਟ ਲਈ ਬਰਾਊਜ਼ਰ ਡਿਵੈਲਪਰ ਟੂਲਜ਼ ਵਰਤੋਂ
- Vue ਪ੍ਰੋਜੈਕਟ ਲਈ Vue DevTools ਬ੍ਰਾਉਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ ਇੰਸਟਾਲ ਕਰੋ
+- Vue ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ Vue DevTools ਬਰਾਊਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ ਇੰਸਟਾਲ ਕਰੋ
-### ਪ੍ਰਦਰਸ਼ਨ ਧਿਆਨ ਵਿੱਚ ਰੱਖਣ ਵਾਲੀਆਂ ਗੱਲਾਂ
+### ਪ੍ਰਦਰਸ਼ਨ ਦੀਆਂ ਗੱਲਾਂ
- 50+ ਭਾਸ਼ਾਵਾਂ ਦੇ ਅਨੁਵਾਦ ਨਾਲ ਕਲੋਨ ਵੱਡਾ ਹੈ
+- ਵੱਡੀ ਗਿਣਤੀ ਵਿੱਚ ਅਨੁਵਾਦਤ ਫਾਇਲਾਂ (50+ ਭਾਸ਼ਾਵਾਂ) ਦੀ ਵਜੇ ਨਾਲ ਪੂਰੇ ਕਲੋਨ ਵੱਡੇ ਹਨ
- ਸਿਰਫ ਸਮੱਗਰੀ `git clone --depth 1` ਨਾਲ ਘੱਟ ਡੈਪਥ ਕਲੋਨ ਕਰੋ
+- ਕੇਵਲ ਸਮੱਗਰੀ 'ਤੇ ਕੰਮ ਕਰ ਰਹੇ ਹੋ ਤਾਂ shallow clone ਵਰਤੋਂ: `git clone --depth 1`
- ਅੰਗ੍ਰੇਜ਼ੀ ਸਮੱਗਰੀ 'ਚ ਕੰਮ ਦੌਰਾਨ ਅਨੁਵਾਦ ਖੋਜ ਤੋਂ ਬਾਹਰ ਰੱਖੋ
+- ਅੰਗਰੇਜ਼ੀ ਸਮੱਗਰੀ ’ਤੇ ਕੰਮ ਕਰਦਿਆਂ ਅਨੁਵਾਦਾਂ ਨੂੰ ਖੋਜ ਤੋਂ ਬਾਹਰ ਰੱਖੋ
- ਪਹਿਲੀ ਵਾਰੀ ਚਲਾਉਣ ਤੇ npm install ਤੇ Vite build ਕਰਨਾ ਧੀਮਾ ਹੋ ਸਕਦਾ ਹੈ
+- ਪਹਿਲੀ ਵਾਰੀ npm install ਅਤੇ Vite build ਦੇ ਕਾਰਨ ਬਿਲਡ ਪ੍ਰਕਿਰਿਆ ਧੀਮੀ ਹੋ ਸਕਦੀ ਹੈ
-## ਸੁਰੱਖਿਆ ਸਬੰਧੀ ਗੱਲਾਂ
+## ਸੁਰੱਖਿਆ ਦੀਆਂ ਗੱਲਾਂ
-### ਵਾਤਾਵਰਣ ਵੇਰੀਏਬਲ
+### ਵਾਤਾਵਰਣ ਚਰ
- API ਕੁੰਜੀਆਂ ਕਦੇ ਭੀ ਰਿਪੋਜ਼ਿਟਰੀ ਵਿਚ ਜਮ੍ਹਾਂ ਨਾ ਕਰੋ
+- API ਕੁੰਜੀਆਂ ਕਦੇ ਵੀ ਰਿਪੋਜ਼ਿਟਰੀ ਵਿੱਚ ਕਮਿੱਟ ਨਾ ਕਰੋ
- `.env` ਫਾਈਲਾਂ ਵਰਤੋ (ਪਹਿਲਾਂ ਹੀ `.gitignore` ਵਿੱਚ ਹਨ)
+- `.env` ਫਾਇਲਾਂ ਵਰਤੋ (ਜੋ `.gitignore` ਵਿੱਚ ਹਨ)
- ਪ੍ਰੋਜੈਕਟ README ਵਿੱਚ ਲੋਜ਼ਮੀ ਵਾਤਾਵਰਣ ਵੇਰੀਏਬਲ ਦਸਤਾਵੇਜ਼ ਕਰੋ
+- ਲੋੜੀਂਦੇ ਵਾਤਾਵਰਣ ਚਰ ਨੂੰ ਪ੍ਰੋਜੈਕਟ README ਫਾਇਲਾਂ ਵਿੱਚ ਦਰਜ ਕਰੋ
 ### Python ਪ੍ਰੋਜੈਕਟ
- ਵਰਚੁਅਲ ਵਾਤਾਵਰਣ ਵਰਤੋਂ: `python -m venv venv`
+- ਵਰਚੁਅਲ ਵਾਤਾਵਰਣ ਵਰਤੋ: `python -m venv venv`
- ਨਿਰਭਰਤਾਵਾਂ ਹਮੇਸ਼ਾ ਅਪਡੇਟ ਰੱਖੋ
+- ਡਿਪੇਂਡੈਂਸੀਜ਼ ਅਪਡੇਟ ਰੱਖੋ
- GitHub ਟੋਕਨਾਂ ਨੂੰ ਘੱਟੋ-ਘੱਟ ਜਰੂਰੀ ਅਧਿਕਾਰ ਦਿਓ
+- GitHub ਟੋਕੇਨ ਨੂੰ ਘੱਟੋ ਘੱਟ ਲੋੜੀਂਦੇ ਅਧਿਕਾਰਾਂ ਨਾਲ ਵਰਤੋਂ
 ### GitHub ਮਾਡਲ ਐਕਸੈਸ
- GitHub ਮਾਡਲ ਲਈ Personal Access Tokens (PAT) ਲਾਜ਼ਮੀ
+- GitHub ਮਾਡਲਾਂ ਲਈ ਪਰਸਨਲ ਐਕਸੈਸ ਟੋਕੇਨ (PAT) ਲੋੜੀਂਦੇ ਹਨ
- ਟੋਕਨ ਵਾਤਾਵਰਣ ਵੇਰੀਏਬਲ ਵਜੋਂ ਸੁਰੱਖਿਅਤ ਰੱਖੋ
+- ਟੋਕੇਨ ਵਾਤਾਵਰਣ ਚਰ ਵਜੋਂ ਰੱਖੋ
- ਕਦੇ ਟੋਕਨਾਂ ਜਾਂ ਲਾਗਇਨ ਜਾਣਕਾਰੀ ਰਿਪੋ ਵਿੱਚ ਭੇਜੋ ਨਾ
+- ਟੋਕੇਨ ਜਾਂ ਪ੍ਰਮਾਣ ਪੱਤਰ ਕਦੇ ਵੀ ਕਮਿੱਟ ਨਾ ਕਰੋ
-## ਵਾਧੂ ਨੋਟਾਂ
+## ਵਧੂ ਨੋਟਸ
-### ਟਾਰਗਟ ਦਰਸ਼ਕ
+### ਲਕੜਾਰਥ ਸੰਗ੍ਰਾਹਕ
- ਵੈੱਬ ਵਿਕਾਸ ਵਿੱਚ ਬਿਲਕੁਲ ਸ਼ੁਰੂਆਤੀ ਲੋਕ
+- ਵੈੱਬ ਵਿਕਾਸ ਵਿੱਚ ਪੂਰਨ ਸ਼ੁਰੂਆਤੀ
- ਵਿਦਿਆਰਥੀ ਅਤੇ ਖ਼ੁਦ ਸਿੱਖਣ ਵਾਲੇ
+- ਵਿਦਿਆਰਥੀ ਅਤੇ ਖੁਦ ਸਿੱਖਣ ਵਾਲੇ
- ਅਧਿਆਪਕ ਜਿਹੜੇ ਕਲਾਸਾਂ ਵਿੱਚ ਕੋਰਸ ਵਰਤਦੇ ਹਨ
+- ਕਲਾਸਰੂਮਾਂ ਵਿੱਚ ਸਿਲੇਬਸ ਦਾ ਉਪਯੋਗ ਕਰਨ ਵਾਲੇ ਅਧਿਆਪਕ
- ਸਮੱਗਰੀ ਪਹੁੰਚਯੋਗ ਅਤੇ ਹੌਲੀ-ਹੌਲੀ ਕੌਸ਼ਲ ਵਿਕਾਸ ਲਈ ਬਨਾਈ ਗਈ
+- ਸਮੱਗਰੀ ਪਹੁੰਚਯੋਗਤਾ ਅਤੇ ਕਦਮ-ਦਰ-ਕਦਮ ਕੌਸ਼ਲ ਵਿਕਾਸ ਲਈ ਤਿਆਰ ਕੀਤੀ ਗਈ ਹੈ
-### ਸਿੱਖਿਆ ਦਾ ਦ੍ਰਿੜ੍ਹ ਨਜ਼ਰੀਆ
+### ਸਿੱਖਣ ਦੀ ਦਾਰਸ਼ਨਿਕਤਾ
- ਪ੍ਰੋਜੈਕਟ-ਆਧਾਰਿਤ ਸਿੱਖਣਾ
+- ਪ੍ਰੋਜੈਕਟ-ਆਧਾਰਿਤ ਸਿੱਖਣ ਦੀ ਪਢ਼ਤਾਲ
- ਅਕਸਰ ਗਿਆਨ ਜਾਂਚ (ਕੁਇਜ਼)
+- ਮੁੜ-ਮੁੜ ਗਿਆਨ ਦੀ ਜਾਂਚ (ਕਵਿਜ਼)
- ਹੱਥ ਨਾਲ ਕੋਡ ਲਿਖਣ ਵਾਲੀਆਂ ਕਸਰਤਾਂ
+- ਹੱਥ-ਵਿੱਚ ਕੋਡਿੰਗ ਅਭਿਆਸ
- ਅਸਲੀ ਦੁਨੀਆ ਦੀਆਂ ਉਦਾਹਰਣਾਂ
+- ਅਸਲੀ ਦੁਨੀਆ ਦੇ ਉਦਾਹਰਣ
- ਫਰੇਮਵਰਕਾਂ ਤੋਂ ਪਹਿਲਾਂ ਮੂਲ ਭੂਤਾਂ 'ਤੇ ਧਿਆਨ
+- ਫਰੇਮਵਰਕਾਂ ਤੋਂ ਪਹਿਲਾਂ ਬੁਨਿਆਦੀ ਜਾਣਕਾਰੀ ’ਤੇ ਧਿਆਨ
-### ਰਿਪੋਜ਼ਿਟਰੀ ਦੇਖ-ਰੇਖ
+### ਰਿਪੋਜ਼ਿਟਰੀ ਦਾ ਸੰਭਾਲ
- ਕਮਿਊਨਿਟੀ ਦੀ ਸਰਗਰਮ ਭਾਗੀਦਾਰੀ
+- ਸਿੱਖਣ ਵਾਲਿਆਂ ਅਤੇ ਯੋਗਦਾਨਕਾਰਾਂ ਦੀ ਸਰਗਰਮ ਸਮੁਦਾਇ
- ਨਿਰਭਰਤਾਵਾਂ ਅਤੇ ਸਮੱਗਰੀ ਨੂੰ ਨਿਯਮਤ ਅਪਡੇਟ
+- ਡਿਪੈਂਡੈਂਸੀਜ਼ ਅਤੇ ਸਮੱਗਰੀ ਦਾ ਨਿਯਮਤ ਅੱਪਡੇਟ
- ਸਮੱਸਿਆਵਾਂ ਅਤੇ ਵਿਚਾਰ-वਟਾਂਦਰੇ ਦੀ ਮਾਨੀਟਰੇਟ
+- ਮੈਨਟੇਨਰਾਂ ਵੱਲੋਂ ਮੁੱਦੇ ਅਤੇ ਗੱਲਬਾਤਨੂੰ ਨਿਗਰਾਨੀ
- GitHub Actions ਨਾਲ ਅਨੁਵਾਦ ਨਵੀਨਕਰਨ
+- ਅਨੁਵਾਦਾਂ ਦੇ ਅੱਪਡੇਟ GitHub Actions ਰਾਹੀਂ ਆਟੋਮੈਟਿਕ
-### ਸੰਬੰਧਿਤ ਸਾਧਨ
+### ਸੰਬੰਧਤ ਸਰੋਤ
- [Microsoft Learn ਮੌਡੀਊਲ](https://docs.microsoft.com/learn/)
+- [Microsoft Learn ਮੋਡਿਊਲ](https://docs.microsoft.com/learn/)
- [Student Hub ਸਰੋਤ](https://docs.microsoft.com/learn/student-hub/)
+- [ਵਿਦਿਆਰਥੀ ਹੋਬ ਸਰੋਤ](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ ਸੁਝਾਅ
+- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ ਸੁਝਾਇਆ ਗਿਆ
- ਹੋਰ ਕੋਰਸ: ਜਨਰੇਟਿਵ AI, ਡਾਟਾ ਸਾਇੰਸ, ML, IoT ਕੋਰਸਾਂ ਉਪਲਬਧ
+- ਵਾਧੂ ਕੋਰਸ: ਜਨਰੇਟਿਵ AI, ਡੇਟਾ ਸਾਇੰਸ, ML, IoT ਸਿਲੇਬਸ ਉਪਲਬਧ
-### ਵਿਸ਼ੇਸ਼ ਪ੍ਰੋਜੈਕਟ ਨਾਲ ਕੰਮ ਕਰਨਾ
+### ਨਿਰਧਾਰਿਤ ਪ੍ਰੋਜੈਕਟਾਂ ਨਾਲ ਕੰਮ
-ਵਿਸ਼ੇਸ਼ ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ ਵਿਸਥਾਰ ਨਾਲ ਦਸਤਾਵੇਜ਼ README ਫਾਈਲਾਂ ਵਿੱਚ ਹਨ:
+ਵਿਸਥਾਰਿਤ ਨਿਰਦੇਸ਼ਾਂ ਲਈ ਹਰੇਕ ਪ੍ਰੋਜੈਕਟ README ਫਾਇਲਾਂ ਨੂੰ ਵੇਖੋ:
- `quiz-app/README.md` - Vue 3 quiz ਐਪਲੀਕੇਸ਼ਨ
+- `quiz-app/README.md` - Vue 3 ਕਵਿਜ਼ অ্যਪਲੀਕੇਸ਼ਨ
- `7-bank-project/README.md` - ਪ੍ਰਮਾਣਿਕਤਾ ਨਾਲ ਬੈਂਕਿੰਗ ਐਪ
+- `7-bank-project/README.md` - ਪ੍ਰਮਾਣਿਕਤਾ ਨਾਲ ਬੈਂਕਿੰਗ ਐਪਲੀਕੇਸ਼ਨ
- `5-browser-extension/README.md` - ਬ੍ਰਾਉਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ ਵਿਕਾਸ
+- `5-browser-extension/README.md` - ਬਰਾਊਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ ਵਿਕਾਸ
- `6-space-game/README.md` - ਕੈਨਵਸ-ਆਧਾਰਿਤ ਗੇਮ ਵਿਕਾਸ
+- `6-space-game/README.md` - ਕੈਨਵਾਸ ਆਧਾਰਤ ਗੇਮ ਵਿਕਾਸ
- `9-chat-project/README.md` - AI ਚੈਟ ਸਹਾਇਕ ਪ੍ਰੋਜੈਕਟ
+- `9-chat-project/README.md` - AI ਚੈਟ ਅਸਿਸਟੈਂਟ ਪ੍ਰੋਜੈਕਟ
-### ਮੋਨੋਰੇਪੋ ਬਣਤਰ
+### ਮੋਨੋਰੇਪੋ ਸੰਰਚਨਾ
-ਪਾਰੰਪਰਿਕ ਮੋਨੋਰੇਪੋ ਨਾ ਹੋਣ ਦੇ ਬਾਵਜੂਦ, ਇਹ ਰਿਪੋਜ਼ਿਟਰੀ ਕਈ ਸਵਤੰਤਰ ਪ੍ਰੋਜੈਕਟ ਹਨ:
+ਇਹ ਪਾਰੰਪਰਿਕ ਮੋਨੋਰੇਪੋ ਨਹੀਂ ਹੈ ਪਰ ਇਸ ਵਿੱਚ ਬਹੁਤ ਸਾਰੇ ਸੁਤੰਤਰ ਪ੍ਰੋਜੈਕਟ ਹਨ:
 - ਹਰ ਪਾਠ ਖੁਦਮੁਖਤਿਆਰ ਹੈ
- ਪ੍ਰੋਜੈਕਟਾਂ ਵਿਚ ਨਿਰਭਰਤਾਵਾਂ ਸਾਂਝੀਆਂ ਨਹੀਂ
+- ਪ੍ਰੋਜੈਕਟਾਂ ਵਿੱਚ ਸਾਂਝੇ ਡਿਪੈਂਡੈਂਸੀਜ਼ ਨਹੀਂ ਹਨ
- ਵਿਅਕਤੀਗਤ ਪ੍ਰੋਜੈਕਟਾਂ 'ਤੇ ਕੰਮ ਕਰੋ ਬਿਨਾ ਦੂਜਿਆਂ 'ਤੇ ਅਸਰ ਪਾਏ
+- ਇਕ-ਦੂਜੇ ਉੱਤੇ ਪ੍ਰਭਾਵ ਨਾ ਪਾਉਂਦੇ ਹੋਏ ਵੱਖ-ਵੱਖ ਪ੍ਰੋਜੈਕਟਾਂ ’ਤੇ ਕੰਮ ਕਰੋ
- ਪੂਰਾ ਕੋਰਸ ਤਜਰਬਾ ਲਈ ਪੂਰੀ ਰਿਪੋ ਕਲੋਨ ਕਰੋ
+- ਪੂਰਾ ਸਿਲੇਬਸ ਅਨੁਭਵ ਲਈ ਸਾਰੀ ਰਿਪੋ ਕਲੋਨ ਕਰੋ
 ---
 <!-- CO-OP TRANSLATOR DISCLAIMER START -->
-**ਅਸਵੀਕਾਰਤਾ**:  
+**ਅਸਵੀਕਾਰੋpetition**:  
-ਇਹ ਦਸਤਾਵੇਜ਼ AI ਅਨੁਵਾਦ ਸੇਵਾ [Co-op Translator](https://github.com/Azure/co-op-translator) ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਅਨੁਵਾਦ ਕੀਤਾ ਗਿਆ ਹੈ। ਜਦੋਂ ਕਿ ਅਸੀਂ ਸਹੀਅਤ ਲਈ ਕੋਸ਼ਿਸ਼ ਕਰਦੇ ਹਾਂ, ਕਿਰਪਾ ਕਰਕੇ ਧਿਆਨ ਰੱਖੋ ਕਿ ਸਵੈਚਾਲਿਤ ਅਨੁਵਾਦ ਵਿੱਚ ਗਲਤੀਆਂ ਜਾਂ ਅਣਸੱਥਤੀਆਂ ਹੋ ਸਕਦੀਆਂ ਹਨ। ਮੂਲ ਦਸਤਾਵੇਜ਼ ਆਪਣੀ ਮੂਲ ਭਾਸ਼ਾ ਵਿੱਚ ਅਧਿਕਾਰਤ ਸਰੋਤ ਮੰਨਿਆ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ। ਮਹੱਤਵਪੂਰਨ ਜਾਣਕਾਰੀ ਲਈ ਪੇਸ਼ੇਵਰ ਮਨੁੱਖੀ ਅਨੁਵਾਦ ਦੀ ਸਿਫ਼ਾਰਿਸ਼ ਕੀਤੀ ਜਾਂਦੀ ਹੈ। ਇਸ ਅਨੁਵਾਦ ਦੀ ਵਰਤੋਂ ਨਾਲ ਪੈਦਾ ਹੋਣ ਵਾਲੀਆਂ ਕਿਸੇ ਵੀ ਗਲਤ ਸਮਝ ਜਾਂ ਗਲਤ ਵਿਆਖਿਆਵਾਂ ਲਈ ਅਸੀਂ ਜਵਾਬਦੇਹ ਨਹੀਂ ਹਾਂ।
+ਇਸ ਦਸਤਾਵੇਜ਼ ਦਾ ਅਨੁਵਾਦ AI ਅਨੁਵਾਦ ਸੇਵਾ [Co-op Translator](https://github.com/Azure/co-op-translator) ਦੀ ਵਰਤੋਂ ਨਾਲ ਕੀਤਾ ਗਿਆ ਹੈ। ਜਦੋਂ ਕਿ ਅਸੀਂ ਸ਼ੁੱਧਤਾ ਲਈ ਕੋਸ਼ਿਸ਼ ਕਰਦੇ ਹਾਂ, ਕਿਰਪਾ ਕਰਕੇ ਧਿਆਨ ਰੱਖੋ ਕਿ ਸਵਚਾਲਿਤ ਅਨੁਵਾਦਾਂ ਵਿੱਚ ਗਲਤੀਆਂ ਜਾਂ ਅਸੰਸ਼ੋਧਿਤੀਆਂ ਹੋ ਸਕਦੀਆਂ ਹਨ। ਇਸ ਦਾ ਮੂਲ ਦਸਤਾਵੇਜ਼ ਆਪਣੀ ਮੂਲ ਭਾਸ਼ਾ ਵਿੱਚ ਇਸਦਾ ਪ੍ਰਮਾਣਿਕ ਸਰੋਤ ਮੰਨਿਆ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ। ਮਹੱਤਵਪੂਰਣ ਜਾਣਕਾਰੀ ਲਈ ਵਿਸ਼ੇਸ਼ਗੀ ਮਨੁੱਖੀ ਅਨੁਵਾਦ ਦੀ ਸਿਫ਼ਾਰਸ਼ ਕੀਤੀ ਜਾਂਦੀ ਹੈ। ਅਸੀਂ ਇਸ ਅਨੁਵਾਦ ਦੀ ਵਰਤੋਂ ਤੋਂ ਉਪਜਣ ਵਾਲੀਆਂ ਕਿਸੇ ਵੀ ਗਲਤਫ਼ਹਮੀ ਜਾਂ ਗਲਤ ਵਿਵਿਚਾਰ ਲਈ ਜ਼ਿੰਮੇਵਾਰ ਨਹੀਂ ਹਾਂ।
 <!-- CO-OP TRANSLATOR DISCLAIMER END -->
--- a/translations/pt-BR/.co-op-translator.json
+++ b/translations/pt-BR/.co-op-translator.json
@ -493,7 +493,7 @@
  },
  "AGENTS.md": {
    "original_hash": "a362efd06d64d4134a0cfe8515a86d34",
-    "translation_date": "2026-04-06T16:40:43+00:00",
+    "translation_date": "2026-04-20T15:51:19+00:00",
    "source_file": "AGENTS.md",
    "language_code": "pt-BR"
  },
--- a/translations/pt-BR/AGENTS.md
+++ b/translations/pt-BR/AGENTS.md
@ -2,29 +2,29 @@
 ## Visão Geral do Projeto
-Este é um repositório educacional para ensinar fundamentos de desenvolvimento web para iniciantes. O currículo é um curso completo de 12 semanas desenvolvido pelos Microsoft Cloud Advocates, com 24 aulas práticas cobrindo JavaScript, CSS e HTML.
+Este é um repositório educacional para ensinar fundamentos de desenvolvimento web a iniciantes. O currículo é um curso abrangente de 12 semanas desenvolvido pelos Microsoft Cloud Advocates, com 24 aulas práticas abordando JavaScript, CSS e HTML.
 ### Componentes Principais
 - **Conteúdo Educacional**: 24 aulas estruturadas organizadas em módulos baseados em projetos  
- **Projetos Práticos**: Terrarium, Jogo de Digitação, Extensão de Navegador, Jogo Espacial, Aplicativo Bancário, Editor de Código e Assistente de Chat com IA
+- **Projetos Práticos**: Terrarium, Jogo de Digitação, Extensão de Navegador, Jogo Espacial, App Bancário, Editor de Código e Assistente de Chat de IA  
- **Questionários Interativos**: 48 questionários com 3 perguntas cada (avaliações pré/pós-aula)
+- **Quizzes Interativos**: 48 quizzes com 3 perguntas cada (avaliações pré e pós-lesson)  
- **Suporte Multilíngue**: Traduções automatizadas para mais de 50 idiomas via GitHub Actions
+- **Suporte Multilíngue**: Traduções automáticas para mais de 50 idiomas via GitHub Actions  
 - **Tecnologias**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (para projetos de IA)  
 ### Arquitetura
- Repositório educacional com estrutura baseada em aulas
+- Repositório educacional com estrutura baseada em lições  
- Cada pasta de aula contém README, exemplos de código e soluções
+- Cada pasta de lição contém README, exemplos de código e soluções  
- Projetos independentes em diretórios separados (quiz-app, vários projetos de aulas)
+- Projetos independentes em diretórios separados (quiz-app, vários projetos de lição)  
 - Sistema de tradução usando GitHub Actions (co-op-translator)  
 - Documentação servida via Docsify e disponível em PDF  
 ## Comandos de Configuração
-Este repositório é voltado principalmente para consumo de conteúdo educacional. Para trabalhar com projetos específicos:
+Este repositório é principalmente para consumo de conteúdo educacional. Para trabalhar com projetos específicos:
-### Configuração do Repositório Principal
+### Configuração Principal do Repositório
 ```bash
 git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
@ -41,7 +41,7 @@ npm run build      # Construir para produção
 npm run lint       # Executar ESLint
 ```
-### API do Projeto Bancário (Node.js + Express)
+### Projeto API Bancária (Node.js + Express)
 ```bash
 cd 7-bank-project/api
@ -72,37 +72,37 @@ npm install
 ```bash
 cd 9-chat-project/solution/backend/python
 pip install openai
-# Definir variável de ambiente GITHUB_TOKEN
+# Defina a variável de ambiente GITHUB_TOKEN
 python api.py
 ```
-## Fluxo de Trabalho para Desenvolvimento
+## Fluxo de Desenvolvimento
 ### Para Contribuidores de Conteúdo
-1. **Faça um fork do repositório** para sua conta no GitHub
+1. **Fork o repositório** para sua conta no GitHub  
 2. **Clone seu fork** localmente  
-3. **Crie um novo branch** para suas alterações
+3. **Crie uma nova branch** para suas alterações  
-4. Faça alterações no conteúdo das aulas ou exemplos de código
+4. Faça mudanças no conteúdo das lições ou exemplos de código  
-5. Teste quaisquer mudanças de código nos diretórios relevantes do projeto
+5. Teste quaisquer alterações de código nos diretórios dos projetos relevantes  
 6. Envie pull requests seguindo as diretrizes de contribuição  
-### Para Estudantes
+### Para Aprendizes
-1. Faça fork ou clone o repositório
+1. Faça fork ou clone do repositório  
-2. Navegue pelas pastas das aulas sequencialmente
+2. Navegue sequencialmente pelos diretórios das lições  
-3. Leia os arquivos README de cada aula
+3. Leia os arquivos README de cada lição  
-4. Complete os questionários pré-aula em https://ff-quizzes.netlify.app/web/
+4. Complete os quizzes pré-lição em https://ff-quizzes.netlify.app/web/  
-5. Trabalhe nos exemplos de código nas pastas das aulas
+5. Trabalhe nos exemplos de código nas pastas da lição  
-6. Complete tarefas e desafios
+6. Complete as tarefas e desafios  
-7. Faça os questionários pós-aula
+7. Faça os quizzes pós-lição  
 ### Desenvolvimento ao Vivo
- **Documentação**: Execute `docsify serve` na raiz (porta 3000)
+- **Documentação**: Rode `docsify serve` na raiz (porta 3000)  
- **Quiz App**: Execute `npm run dev` no diretório quiz-app
+- **Quiz App**: Rode `npm run dev` no diretório quiz-app  
 - **Projetos**: Use a extensão Live Server do VS Code para projetos HTML  
- **Projetos API**: Execute `npm start` nos diretórios das APIs correspondentes
+- **Projetos API**: Rode `npm start` nos diretórios das APIs respectivas  
 ## Instruções de Teste
@ -110,8 +110,8 @@ python api.py
 ```bash
 cd quiz-app
-npm run lint       # Verifique problemas de estilo de código
+npm run lint       # Verificar problemas de estilo de código
-npm run build      # Verifique se a compilação é bem-sucedida
+npm run build      # Verificar se a compilação foi bem-sucedida
 ```
 ### Teste da API Bancária
@ -122,21 +122,21 @@ npm run lint       # Verificar problemas de estilo de código
 node server.js     # Verificar se o servidor inicia sem erros
 ```
-### Abordagem Geral de Testes
+### Abordagem Geral de Teste
 - Este é um repositório educacional sem testes automatizados abrangentes  
- Testes manuais focam em:
+- Teste manual foca em:  
-  - Exemplos de código executam sem erros
+  - Exemplos de código executando sem erros  
-  - Links na documentação funcionam corretamente
+  - Links na documentação funcionando corretamente  
-  - Builds dos projetos concluem com sucesso
+  - Builds dos projetos completando com sucesso  
-  - Exemplos seguem boas práticas
+  - Exemplos seguindo as melhores práticas  
-### Checagens Antes do Envio
+### Checagens Pré-envio
 - Execute `npm run lint` em diretórios com package.json  
- Verifique se os links em markdown são válidos
+- Verifique se os links markdown são válidos  
 - Teste exemplos de código no navegador ou Node.js  
- Verifique se as traduções mantêm a estrutura correta
+- Verifique que as traduções mantêm a estrutura adequada  
 ## Diretrizes de Estilo de Código
@ -144,60 +144,60 @@ node server.js     # Verificar se o servidor inicia sem erros
 - Use sintaxe moderna ES6+  
 - Siga as configurações padrão do ESLint fornecidas nos projetos  
- Use nomes de variáveis e funções significativos para clareza educacional
+- Use nomes significativos para variáveis e funções para clareza educacional  
- Adicione comentários explicando conceitos para estudantes
+- Adicione comentários explicando conceitos para os aprendizes  
- Formate usando Prettier onde configurado
+- Formate usando Prettier quando configurado  
 ### HTML/CSS
 - Elementos semânticos HTML5  
 - Princípios de design responsivo  
 - Convenções claras de nomenclatura de classes  
- Comentários explicando técnicas CSS para estudantes
+- Comentários explicando técnicas CSS para aprendizes  
 ### Python
 - Diretrizes de estilo PEP 8  
- Exemplos claros e educacionais
+- Exemplos de código claros e educacionais  
- Anotações de tipo úteis para aprendizado
+- Dicas de tipo onde úteis para aprendizagem  
-### Documentação Markdown
+### Documentação em Markdown
 - Hierarquia clara de títulos  
 - Blocos de código com especificação de linguagem  
 - Links para recursos adicionais  
 - Capturas de tela e imagens nas pastas `images/`  
- Texto alternativo para acessibilidade das imagens
+- Texto alternativo para imagens para acessibilidade  
 ### Organização de Arquivos
- Aulas numeradas sequencialmente (1-getting-started-lessons, 2-js-basics, etc.)
+- Lições numeradas sequencialmente (1-getting-started-lessons, 2-js-basics, etc.)  
- Cada projeto possui diretórios `solution/` e frequentemente `start/` ou `your-work/`
+- Cada projeto tem diretórios `solution/` e frequentemente `start/` ou `your-work/`  
- Imagens armazenadas em pastas específicas `images/` de cada aula
+- Imagens armazenadas em pastas `images/` específicas da lição  
 - Traduções na estrutura `translations/{language-code}/`  
-## Build e Implantação
+## Build e Deploy
-### Implantação do Quiz App (Azure Static Web Apps)
+### Deploy do Quiz App (Azure Static Web Apps)
-O quiz-app está configurado para implantação no Azure Static Web Apps:
+O quiz-app está configurado para deploy no Azure Static Web Apps:
 ```bash
 cd quiz-app
 npm run build      # Cria a pasta dist/
-# Faz o deploy via workflow do GitHub Actions ao enviar para a branch main
+# Implanta via workflow do GitHub Actions ao enviar para a branch main
 ```
-Configuração do Azure Static Web Apps:
+Configuração Azure Static Web Apps:  
- **Localização do app**: `/quiz-app`
+- **Localização da app**: `/quiz-app`  
 - **Localização de saída**: `dist`  
 - **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`  
 ### Geração de PDF da Documentação
 ```bash
-npm install                    # Instale docsify-to-pdf
+npm install                    # Instalar docsify-to-pdf
-npm run convert               # Gere PDF a partir do docs
+npm run convert               # Gerar PDF a partir do docs
 ```
 ### Documentação Docsify
@ -207,74 +207,74 @@ npm install -g docsify-cli    # Instalar Docsify globalmente
 docsify serve                 # Servir em localhost:3000
 ```
-### Builds Específicos por Projeto
+### Builds específicos de projetos
 Cada diretório de projeto pode ter seu próprio processo de build:  
- Projetos Vue: `npm run build` cria pacotes de produção
+- Projetos Vue: `npm run build` cria bundles para produção  
- Projetos estáticos: Sem passo de build, sirva os arquivos diretamente
+- Projetos estáticos: Sem etapa de build, servem arquivos diretamente  
 ## Diretrizes para Pull Requests
 ### Formato do Título
-Use títulos claros e descritivos indicando a área da mudança:
+Use títulos claros e descritivos indicando a área de mudança:  
- `[Quiz-app] Adicionar novo quiz para a lição X`
+- `[Quiz-app] Add new quiz for lesson X`  
- `[Lesson-3] Corrigir erro de digitação no projeto terrarium`
+- `[Lesson-3] Fix typo in terrarium project`  
- `[Translation] Adicionar tradução para espanhol na lição 5`
+- `[Translation] Add Spanish translation for lesson 5`  
- `[Docs] Atualizar instruções de configuração`
+- `[Docs] Update setup instructions`  
-### Verificações Necessárias
+### Checagens Necessárias
 Antes de enviar um PR:
 1. **Qualidade do Código**:  
-   - Execute `npm run lint` nos diretórios dos projetos afetados
+   - Rode `npm run lint` nos diretórios afetados  
-   - Corrija todos os erros e avisos do lint
+   - Corrija todos os erros e avisos de lint  
-2. **Verificação do Build**:
+2. **Verificação de Build**:  
-   - Execute `npm run build` se aplicável
+   - Rode `npm run build` se aplicável  
-   - Garanta que não haja erros no build
+   - Garanta que não ocorram erros no build  
 3. **Validação de Links**:  
-   - Teste todos os links em markdown
+   - Teste todos os links markdown  
-   - Verifique se referências de imagens funcionam
+   - Verifique referências a imagens  
-4. **Revisão do Conteúdo**:
+4. **Revisão de Conteúdo**:  
   - Revise ortografia e gramática  
-   - Assegure que exemplos de código estão corretos e educacionais
+   - Assegure que exemplos de código estão corretos e educativos  
-   - Verifique se traduções mantêm o significado original
+   - Verifique que as traduções mantêm o significado original  
-### Requisitos para Contribuição
+### Requisitos de Contribuição
- Aceitar a CLA da Microsoft (verificação automática no primeiro PR)
+- Aceite o CLA da Microsoft (verificação automática no primeiro PR)  
- Seguir o [Código de Conduta de Código Aberto da Microsoft](https://opensource.microsoft.com/codeofconduct/)
+- Siga o [Código de Conduta Open Source da Microsoft](https://opensource.microsoft.com/codeofconduct/)  
- Ver [CONTRIBUTING.md](./CONTRIBUTING.md) para diretrizes detalhadas
+- Veja [CONTRIBUTING.md](./CONTRIBUTING.md) para diretrizes detalhadas  
- Referenciar números de issues na descrição do PR, se aplicável
+- Referencie números de issues na descrição do PR, se aplicável  
 ### Processo de Revisão
- PRs revisados por mantenedores e comunidade
+- PRs são revisados por mantenedores e comunidade  
- Clareza educacional é priorizada
+- Clareza educacional tem prioridade  
 - Exemplos de código devem seguir melhores práticas atuais  
- Traduções revisadas quanto a precisão e adequação cultural
+- Traduções revisadas quanto à precisão e adequação cultural  
 ## Sistema de Tradução
 ### Tradução Automatizada
 - Usa GitHub Actions com workflow co-op-translator  
- Traduz automaticamente para mais de 50 idiomas
+- Traduz para mais de 50 idiomas automaticamente  
- Arquivos fonte nos diretórios principais
+- Arquivos originais nos diretórios principais  
 - Arquivos traduzidos em `translations/{language-code}/`  
-### Adicionando Melhorias Manuais na Tradução
+### Adicionando Melhorias Manuais nas Traduções
 1. Localize o arquivo em `translations/{language-code}/`  
 2. Faça melhorias preservando a estrutura  
-3. Certifique-se que exemplos de código continuam funcionais
+3. Garanta que exemplos de código permanecem funcionais  
-4. Teste qualquer conteúdo localizado dos quizzes
+4. Teste qualquer conteúdo de quiz localizado  
-### Metadados da Tradução
+### Metadados de Tradução
 Arquivos traduzidos incluem cabeçalho de metadados:  
 ```markdown
@ -293,43 +293,43 @@ CO_OP_TRANSLATOR_METADATA:
 ### Problemas Comuns
-**Quiz app não inicia**:
+**O quiz app não inicia**:  
 - Verifique a versão do Node.js (recomendado v14+)  
- Apague `node_modules` e `package-lock.json`, execute `npm install` novamente
+- Apague `node_modules` e `package-lock.json`, rode `npm install` novamente  
- Verifique conflitos de porta (padrão: Vite usa porta 5173)
+- Verifique conflitos de portas (padrão: Vite usa porta 5173)  
 **Servidor API não inicia**:  
- Confirme que Node.js atende o mínimo (node >=10)
+- Confirme a versão mínima do Node.js (node >=10)  
- Verifique se a porta já não está em uso
+- Verifique se a porta não está em uso  
- Garanta que todas as dependências estejam instaladas com `npm install`
+- Garanta que todas as dependências foram instaladas com `npm install`  
-**Extensão do navegador não carrega**:
+**Extensão de navegador não carrega**:  
 - Verifique se o manifest.json está formatado corretamente  
- Confira o console do navegador para erros
+- Verifique erros no console do navegador  
- Siga as instruções específicas para instalação da extensão no navegador
+- Siga as instruções específicas de instalação da extensão para o navegador  
 **Problemas no projeto de chat Python**:  
- Assegure que o pacote OpenAI está instalado: `pip install openai`
+- Certifique-se que o pacote OpenAI está instalado: `pip install openai`  
 - Verifique se a variável de ambiente GITHUB_TOKEN está definida  
- Confirme permissões de acesso aos GitHub Models
+- Confirme as permissões de acesso ao GitHub Models  
 **Docsify não serve a documentação**:  
- Instale globalmente o docsify-cli: `npm install -g docsify-cli`
+- Instale docsify-cli globalmente: `npm install -g docsify-cli`  
- Execute a partir do diretório raiz do repositório
+- Rode a partir do diretório raiz do repositório  
- Verifique se o arquivo `docs/_sidebar.md` existe
+- Confira se `docs/_sidebar.md` existe  
 ### Dicas para Ambiente de Desenvolvimento
- Use VS Code com a extensão Live Server para projetos HTML
+- Use VS Code com extensão Live Server para projetos HTML  
- Instale extensões ESLint e Prettier para formatação consistente
+- Instale as extensões ESLint e Prettier para formatação consistente  
 - Use DevTools do navegador para depurar JavaScript  
- Para projetos Vue, instale a extensão Vue DevTools no navegador
+- Para projetos Vue, instale a extensão Vue DevTools para navegador  
 ### Considerações de Performance
- Grande número de arquivos traduzidos (mais de 50 idiomas) torna clones completos grandes
+- Grande número de arquivos traduzidos (50+ idiomas) torna clones completos grandes  
- Use clone superficial se trabalhar somente com conteúdo: `git clone --depth 1`
+- Use clone raso se estiver trabalhando apenas no conteúdo: `git clone --depth 1`  
- Exclua traduções das buscas ao trabalhar com conteúdo em inglês
+- Exclua traduções das buscas ao trabalhar no conteúdo em inglês  
 - Processos de build podem ser lentos na primeira execução (npm install, build Vite)  
 ## Considerações de Segurança
@ -337,72 +337,72 @@ CO_OP_TRANSLATOR_METADATA:
 ### Variáveis de Ambiente
 - Chaves de API nunca devem ser commitadas no repositório  
- Use arquivos `.env` (já no `.gitignore`)
+- Use arquivos `.env` (já listados no `.gitignore`)  
- Documente variáveis de ambiente necessárias nos README dos projetos
+- Documente variáveis de ambiente necessárias nos READMEs dos projetos  
 ### Projetos Python
 - Use ambientes virtuais: `python -m venv venv`  
- Mantenha dependências atualizadas
+- Mantenha as dependências atualizadas  
- Tokens do GitHub devem ter permissões mínimas necessárias
+- Tokens GitHub devem ter permissões mínimas necessárias  
-### Acesso aos GitHub Models
+### Acesso GitHub Models
- Tokens de Acesso Pessoal (PAT) são necessários para GitHub Models
+- Tokens de Acesso Pessoal (PAT) são exigidos para GitHub Models  
- Armazene tokens como variáveis de ambiente
+- Os tokens devem ser armazenados como variáveis de ambiente  
- Nunca faça commit de tokens ou credenciais
+- Nunca commit tokens ou credenciais  
 ## Notas Adicionais
-### Público-Alvo
+### Público-alvo
 - Iniciantes completos em desenvolvimento web  
 - Estudantes e autodidatas  
- Professores usando o currículo em salas de aula
+- Professores utilizando o currículo em salas de aula  
- Conteúdo projetado para acessibilidade e construção gradual de habilidades
+- Conteúdo desenhado para acessibilidade e construção gradual de habilidades  
 ### Filosofia Educacional
- Abordagem de aprendizado baseado em projetos
+- Abordagem de aprendizado baseada em projetos  
 - Verificações frequentes de conhecimento (quizzes)  
 - Exercícios práticos de codificação  
 - Exemplos de aplicação no mundo real  
- Foco nos fundamentos antes de frameworks
+- Foco em fundamentos antes de frameworks  
 ### Manutenção do Repositório
- Comunidade ativa de aprendizes e contribuidores
+- Comunidade ativa de aprendizes e contribuintes  
- Atualizações regulares de dependências e conteúdo
+- Atualizações regulares em dependências e conteúdo  
 - Issues e discussões monitoradas por mantenedores  
 - Atualizações de tradução automatizadas via GitHub Actions  
 ### Recursos Relacionados
 - [Módulos Microsoft Learn](https://docs.microsoft.com/learn/)  
- [Recursos do Student Hub](https://docs.microsoft.com/learn/student-hub/)
+- [Recursos Student Hub](https://docs.microsoft.com/learn/student-hub/)  
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) recomendado para estudantes
+- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) recomendado para aprendizes  
- Cursos adicionais: AI Generativa, Ciência de Dados, ML, IoT disponíveis
+- Cursos adicionais: AI Generativa, Ciência de Dados, ML, currículos IoT disponíveis  
 ### Trabalhando com Projetos Específicos
 Para instruções detalhadas sobre projetos individuais, consulte os arquivos README em:  
- `quiz-app/README.md` - aplicação de quiz Vue 3
+- `quiz-app/README.md` - Aplicação de quiz Vue 3  
- `7-bank-project/README.md` - aplicativo bancário com autenticação
+- `7-bank-project/README.md` - Aplicação bancária com autenticação  
- `5-browser-extension/README.md` - desenvolvimento de extensão de navegador
+- `5-browser-extension/README.md` - Desenvolvimento de extensão de navegador  
- `6-space-game/README.md` - desenvolvimento de jogo baseado em canvas
+- `6-space-game/README.md` - Desenvolvimento de jogo baseado em canvas  
- `9-chat-project/README.md` - projeto assistente de chat com IA
+- `9-chat-project/README.md` - Projeto assistente de chat IA  
 ### Estrutura Monorepo
 Embora não seja um monorepo tradicional, este repositório contém múltiplos projetos independentes:  
- Cada aula é autossuficiente
+- Cada lição é autocontida  
 - Projetos não compartilham dependências  
 - Trabalhe em projetos individuais sem afetar outros  
- Clone o repositório completo para a experiência do curso completo
+- Faça clone do repositório completo para experiência total do currículo  
 ---
 <!-- CO-OP TRANSLATOR DISCLAIMER START -->
 **Aviso Legal**:  
-Este documento foi traduzido usando o serviço de tradução por IA [Co-op Translator](https://github.com/Azure/co-op-translator). Embora nos esforcemos para garantir a precisão, esteja ciente de que traduções automáticas podem conter erros ou imprecisões. O documento original em seu idioma nativo deve ser considerado a fonte autorizada. Para informações críticas, recomenda-se a tradução profissional humana. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações incorretas decorrentes do uso desta tradução.
+Este documento foi traduzido utilizando o serviço de tradução por IA [Co-op Translator](https://github.com/Azure/co-op-translator). Embora nos esforcemos para garantir a precisão, por favor, esteja ciente de que traduções automatizadas podem conter erros ou imprecisões. O documento original em sua língua nativa deve ser considerado a fonte autorizada. Para informações críticas, recomenda-se a tradução profissional realizada por humanos. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações incorretas decorrentes do uso desta tradução.
 <!-- CO-OP TRANSLATOR DISCLAIMER END -->
--- a/translations/pt-PT/.co-op-translator.json
+++ b/translations/pt-PT/.co-op-translator.json
@ -493,7 +493,7 @@
  },
  "AGENTS.md": {
    "original_hash": "a362efd06d64d4134a0cfe8515a86d34",
-    "translation_date": "2026-04-06T16:39:35+00:00",
+    "translation_date": "2026-04-20T15:49:55+00:00",
    "source_file": "AGENTS.md",
    "language_code": "pt-PT"
  },
--- a/translations/pt-PT/AGENTS.md
+++ b/translations/pt-PT/AGENTS.md
@ -2,13 +2,13 @@
 ## Visão Geral do Projeto
-Este é um repositório de currículo educativo para ensinar os fundamentos do desenvolvimento web a iniciantes. O currículo é um curso abrangente de 12 semanas desenvolvido pelos Microsoft Cloud Advocates, com 24 lições práticas que cobrem JavaScript, CSS e HTML.
+Este é um repositório de currículo educativo para ensinar fundamentos do desenvolvimento web a iniciantes. O currículo é um curso abrangente de 12 semanas desenvolvido pelos Microsoft Cloud Advocates, apresentando 24 lições práticas que cobrem JavaScript, CSS e HTML.
 ### Componentes Principais
 - **Conteúdo Educativo**: 24 lições estruturadas organizadas em módulos baseados em projetos
- **Projetos Práticos**: Terrário, Jogo de Digitação, Extensão de Navegador, Jogo Espacial, Aplicação Bancária, Editor de Código e Assistente de Chat de IA
+- **Projetos Práticos**: Terrarium, Jogo de Digitação, Extensão de Navegador, Jogo Espacial, Aplicação Bancária, Editor de Código e Assistente de Chat IA
- **Questionários Interativos**: 48 questionários com 3 perguntas cada (avaliações pré e pós-lição)
+- **Questionários Interativos**: 48 questionários com 3 perguntas cada (avaliações pré/pós-lição)
 - **Suporte Multilíngue**: Traduções automáticas para mais de 50 idiomas via GitHub Actions
 - **Tecnologias**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (para projetos de IA)
@ -16,8 +16,8 @@ Este é um repositório de currículo educativo para ensinar os fundamentos do d
 - Repositório educativo com estrutura baseada em lições
 - Cada pasta de lição contém README, exemplos de código e soluções
- Projetos autónomos em diretórios separados (quiz-app, vários projetos de lições)
+- Projetos independentes em diretórios separados (quiz-app, vários projetos de lição)
- Sistema de tradução utilizando GitHub Actions (co-op-translator)
+- Sistema de tradução usando GitHub Actions (co-op-translator)
 - Documentação servida via Docsify e disponível em PDF
 ## Comandos de Configuração
@ -31,7 +31,7 @@ git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
 cd Web-Dev-For-Beginners
 ```
-### Configuração da Quiz App (Vue 3 + Vite)
+### Configuração do Quiz App (Vue 3 + Vite)
 ```bash
 cd quiz-app
@ -59,12 +59,12 @@ npm install
 # Siga as instruções específicas do navegador para carregar extensões
 ```
-### Projetos do Jogo Espacial
+### Projetos de Jogo Espacial
 ```bash
 cd 6-space-game/solution
 npm install
-# Abra index.html no navegador ou use Live Server
+# Abra index.html no navegador ou use o Live Server
 ```
 ### Projeto de Chat (Backend em Python)
@ -72,7 +72,7 @@ npm install
 ```bash
 cd 9-chat-project/solution/backend/python
 pip install openai
-# Definir a variável de ambiente GITHUB_TOKEN
+# Definir variável de ambiente GITHUB_TOKEN
 python api.py
 ```
@ -80,41 +80,41 @@ python api.py
 ### Para Contribuidores de Conteúdo
-1. **Faça fork do repositório** para sua conta GitHub
+1. **Faça fork do repositório** na sua conta GitHub
 2. **Clone o seu fork** localmente
-3. **Crie uma nova branch** para suas alterações
+3. **Crie uma nova branch** para as suas alterações
-4. Faça alterações no conteúdo das lições ou nos exemplos de código
+4. Faça alterações no conteúdo da lição ou nos exemplos de código
-5. Teste quaisquer alterações de código nos diretórios dos projetos relevantes
+5. Teste quaisquer alterações de código nos diretórios de projeto relevantes
 6. Submeta pull requests seguindo as diretrizes de contribuição
 ### Para Aprendizes
-1. Fork ou clone o repositório
+1. Faça fork ou clone o repositório
-2. Navegue pelas pastas das lições sequencialmente
+2. Navegue sequencialmente pelos diretórios das lições
 3. Leia os ficheiros README de cada lição
-4. Complete os questionários pré-lição em https://ff-quizzes.netlify.app/web/
+4. Complete os quizzes pré-lição em https://ff-quizzes.netlify.app/web/
-5. Trabalhe nos exemplos de código nas pastas das lições
+5. Trabalhe os exemplos de código nas pastas das lições
-6. Complete tarefas e desafios
+6. Complete trabalhos e desafios
-7. Faça os questionários pós-lição
+7. Realize os quizzes pós-lição
-### Desenvolvimento em Tempo Real
+### Desenvolvimento ao Vivo
 - **Documentação**: Execute `docsify serve` na raiz (porta 3000)
- **Quiz App**: Execute `npm run dev` na pasta quiz-app
+- **Quiz App**: Execute `npm run dev` no diretório quiz-app
 - **Projetos**: Use a extensão Live Server do VS Code para projetos HTML
- **Projetos API**: Execute `npm start` nos respetivos diretórios API
+- **Projetos API**: Execute `npm start` nos diretórios API respetivos
-## Instruções de Testes
+## Instruções de Teste
-### Testes da Quiz App
+### Teste do Quiz App
 ```bash
 cd quiz-app
 npm run lint       # Verificar problemas de estilo de código
-npm run build      # Verificar se a compilação tem sucesso
+npm run build      # Verificar se a compilação é bem-sucedida
 ```
-### Testes da API Bancária
+### Teste da API Bancária
 ```bash
 cd 7-bank-project/api
@ -124,73 +124,73 @@ node server.js     # Verificar se o servidor inicia sem erros
 ### Abordagem Geral de Testes
- Este é um repositório educativo sem testes automáticos abrangentes
+- Este é um repositório educativo sem testes automatizados abrangentes
- Testes manuais focam em:
+- O teste manual foca-se em:
-  - Exemplos de código executam sem erros
+  - Exemplos de código que executam sem erros
  - Links na documentação funcionam corretamente
-  - Construções dos projetos completam com sucesso
+  - Builds dos projetos completam com sucesso
-  - Exemplos seguem as melhores práticas
+  - Exemplos seguem as boas práticas
-### Verificações Pré-envio
+### Verificações Pré-Submissão
- Execute `npm run lint` nas pastas com package.json
+- Execute `npm run lint` nos diretórios com package.json
- Verifique se os links markdown são válidos
+- Verifique que os links markdown são válidos
- Teste os exemplos de código no navegador ou Node.js
+- Teste exemplos de código no navegador ou Node.js
- Confirme que as traduções mantêm a estrutura correta
+- Confirme que as traduções mantêm a estrutura adequada
 ## Diretrizes de Estilo de Código
 ### JavaScript
 - Use sintaxe moderna ES6+
- Siga as configurações padrão ESLint fornecidas nos projetos
+- Siga as configurações padrão do ESLint fornecidas nos projetos
- Use nomes de variáveis e funções significativos para clareza educativa
+- Use nomes significativos de variáveis e funções para clareza educativa
- Adicione comentários explicando conceitos para os aprendizes
+- Adicione comentários explicativos para os conceitos
- Formate usando Prettier onde configurado
+- Formate com Prettier onde estiver configurado
 ### HTML/CSS
 - Elementos semânticos HTML5
 - Princípios de design responsivo
- Convenções claras de nomenclatura de classes
+- Convenções claras de nomeação de classes
- Comentários explicando técnicas CSS para os aprendizes
+- Comentários explicando técnicas CSS para aprendizes
 ### Python
 - Diretrizes de estilo PEP 8
 - Exemplos de código claros e educativos
- Anotações de tipos onde úteis para o aprendizado
+- Anotações de tipo onde ajudarem na aprendizagem
 ### Documentação Markdown
 - Hierarquia clara de títulos
- Blocos de código com especificação da linguagem
+- Blocos de código com especificação de linguagem
 - Links para recursos adicionais
- Capturas de tela e imagens nas pastas `images/`
+- Capturas de ecrã e imagens nas pastas `images/`
 - Texto alternativo para imagens para acessibilidade
 ### Organização de Ficheiros
 - Lições numeradas sequencialmente (1-getting-started-lessons, 2-js-basics, etc.)
- Cada projeto possui diretórios `solution/` e frequentemente `start/` ou `your-work/`
+- Cada projeto tem diretórios `solution/` e frequentemente `start/` ou `your-work/`
- Imagens armazenadas em pastas `images/` específicas de cada lição
+- Imagens guardadas nas pastas `images/` específicas da lição
 - Traduções em estrutura `translations/{language-code}/`
-## Construção e Deploy
+## Construção e Implementação
-### Deploy da Quiz App (Azure Static Web Apps)
+### Deploy do Quiz App (Azure Static Web Apps)
-A quiz-app está configurada para deployment em Azure Static Web Apps:
+O quiz-app está configurado para deploy em Azure Static Web Apps:
 ```bash
 cd quiz-app
 npm run build      # Cria a pasta dist/
-# Faz o deploy através do workflow do GitHub Actions ao fazer push para a main
+# Faz o deploy através do fluxo de trabalho do GitHub Actions ao fazer push para a main
 ```
 Configuração Azure Static Web Apps:
 - **Localização da app**: `/quiz-app`
- **Localização da saída**: `dist`
+- **Localização de saída**: `dist`
 - **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
 ### Geração de PDF da Documentação
@ -203,11 +203,11 @@ npm run convert               # Gerar PDF a partir do docs
 ### Documentação Docsify
 ```bash
-npm install -g docsify-cli    # Instalar o Docsify globalmente
+npm install -g docsify-cli    # Instalar Docsify globalmente
 docsify serve                 # Servir em localhost:3000
 ```
-### Builds Específicos de Projetos
+### Builds Específicos por Projeto
 Cada diretório de projeto pode ter seu próprio processo de build:
 - Projetos Vue: `npm run build` cria bundles para produção
@ -217,62 +217,62 @@ Cada diretório de projeto pode ter seu próprio processo de build:
 ### Formato do Título
-Use títulos claros e descritivos indicando a área da alteração:
+Use títulos claros e descritivos indicativos da área de alteração:
- `[Quiz-app] Adicionar novo quiz para a lição X`
+- `[Quiz-app] Adicionar novo quiz para lição X`
 - `[Lesson-3] Corrigir erro tipográfico no projeto terrarium`
- `[Translation] Adicionar tradução em espanhol para a lição 5`
+- `[Translation] Adicionar tradução para espanhol na lição 5`
 - `[Docs] Atualizar instruções de configuração`
-### Verificações Obrigatórias
+### Verificações Necessárias
 Antes de submeter um PR:
-1. **Qualidade de Código**:
+1. **Qualidade do Código**:
-   - Execute `npm run lint` nos diretórios dos projetos afetados
+   - Execute `npm run lint` nos diretórios de projeto afetados
-   - Corrija todos os erros e avisos de linting
+   - Corrija todos os erros e avisos de lint
-2. **Verificação de Build**:
+2. **Verificação do Build**:
   - Execute `npm run build` se aplicável
-   - Assegure que não existem erros no build
+   - Garanta ausência de erros no build
 3. **Validação de Links**:
-   - Teste todos os links de markdown
+   - Teste todos os links markdown
-   - Verifique referências de imagens funcionais
+   - Verifique referências de imagens
 4. **Revisão de Conteúdo**:
   - Revise ortografia e gramática
-   - Confirme que exemplos de código estão corretos e educativos
+   - Confirme que os exemplos de código estão corretos e educativos
-   - Verifique que traduções mantêm o significado original
+   - Verifique que as traduções mantêm o significado original
 ### Requisitos de Contribuição
- Aceitar o CLA da Microsoft (verificação automática no 1.º PR)
+- Concordar com o CLA da Microsoft (verificação automática no primeiro PR)
- Seguir o [Código de Conduta Open Source da Microsoft](https://opensource.microsoft.com/codeofconduct/)
+- Seguir o [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Ver [CONTRIBUTING.md](./CONTRIBUTING.md) para diretrizes detalhadas
+- Consultar [CONTRIBUTING.md](./CONTRIBUTING.md) para diretrizes detalhadas
 - Referenciar números de issues na descrição do PR, se aplicável
 ### Processo de Revisão
- PRs são revistos pelos mantenedores e comunidade
+- PRs revistos por mantenedores e comunidade
- Clareza educativa é prioritária
+- Clareza educativa é prioridade
 - Exemplos de código devem seguir as melhores práticas atuais
- Traduções são revistas para precisão e adequação cultural
+- Traduções revisadas quanto a exatidão e adequação cultural
 ## Sistema de Tradução
 ### Tradução Automática
 - Usa GitHub Actions com workflow co-op-translator
- Tradução automática para mais de 50 idiomas
+- Traduz para mais de 50 idiomas automaticamente
- Ficheiros originais nos diretórios principais
+- Ficheiros fonte nos diretórios principais
 - Ficheiros traduzidos em `translations/{language-code}/`
-### Adicionar Melhorias Manuais às Traduções
+### Adição de Melhorias Manuais de Tradução
 1. Localize o ficheiro em `translations/{language-code}/`
-2. Faça melhorias mantendo a estrutura
+2. Faça melhorias preservando a estrutura
-3. Assegure que exemplos de código continuam funcionais
+3. Garanta que exemplos de código permanecem funcionais
-4. Teste qualquer conteúdo local de quiz
+4. Teste qualquer conteúdo de quizzes localizado
 ### Metadados de Tradução
@ -293,64 +293,64 @@ CO_OP_TRANSLATOR_METADATA:
 ### Problemas Comuns
-**Quiz app não inicia**:
+**App do Quiz não inicia**:
- Verifique versão do Node.js (recomendado v14+)
+- Verifique a versão do Node.js (recomendado v14+)
 - Apague `node_modules` e `package-lock.json`, execute `npm install` novamente
 - Verifique conflitos de porta (padrão: Vite usa porta 5173)
 **Servidor API não inicia**:
- Confirme que versão do Node.js é mínima (node >=10)
+- Confirme que a versão do Node.js é mínima (node >=10)
 - Verifique se a porta já está em uso
- Assegure que todas as dependências estão instaladas com `npm install`
+- Certifique-se de que todas as dependências foram instaladas com `npm install`
-**Extensão do navegador não carrega**:
+**Extensão de navegador não carrega**:
- Verifique se o manifest.json está corretamente formatado
+- Verifique se o manifest.json está formatado corretamente
- Consulte a consola do navegador para erros
+- Consulte o console do navegador para erros
- Siga instruções específicas do navegador para instalação da extensão
+- Siga as instruções específicas do navegador para instalação de extensões
 **Problemas no projeto de chat em Python**:
- Assegure que o pacote OpenAI está instalado: `pip install openai`
+- Certifique-se de que o pacote OpenAI está instalado: `pip install openai`
- Verifique variável de ambiente GITHUB_TOKEN definida
+- Verifique se a variável de ambiente GITHUB_TOKEN está definida
- Verifique permissões de acesso do GitHub Models
+- Confirme as permissões de acesso aos GitHub Models
 **Docsify não serve documentação**:
 - Instale docsify-cli globalmente: `npm install -g docsify-cli`
- Execute a partir do diretório raiz do repositório
+- Execute desde o diretório raiz do repositório
- Verifique que `docs/_sidebar.md` existe
+- Verifique se `docs/_sidebar.md` existe
-### Dicas de Ambiente de Desenvolvimento
+### Dicas para o Ambiente de Desenvolvimento
- Use VS Code com extensão Live Server para projetos HTML
+- Use VS Code com a extensão Live Server para projetos HTML
 - Instale extensões ESLint e Prettier para formatação consistente
- Use DevTools do navegador para depurar JavaScript
+- Utilize DevTools do navegador para depurar JavaScript
- Para projetos Vue, instale extensão Vue DevTools no navegador
+- Para projetos Vue, instale a extensão Vue DevTools no navegador
 ### Considerações de Performance
- Grande número de ficheiros traduzidos (mais de 50 idiomas) torna clones completos grandes
+- Grande quantidade de ficheiros traduzidos (50+ idiomas) torna os clones completos pesados
 - Use clone superficial se trabalhar apenas com conteúdo: `git clone --depth 1`
- Exclua traduções de pesquisas ao trabalhar no conteúdo em inglês
+- Exclua traduções de pesquisas ao trabalhar com conteúdo em inglês
 - Processos de build podem ser lentos na primeira execução (npm install, build Vite)
 ## Considerações de Segurança
 ### Variáveis de Ambiente
- Chaves de API nunca devem ser commitadas no repositório
+- Chaves API nunca devem ser commitadas no repositório
- Use ficheiros `.env` (já em `.gitignore`)
+- Use ficheiros `.env` (já listados no `.gitignore`)
- Documente variáveis de ambiente requeridas nos READMEs do projeto
+- Documente as variáveis de ambiente necessárias nos READMEs dos projetos
-### Projetos em Python
+### Projetos Python
- Use ambientes virtuais: `python -m venv venv`
+- Utilize ambientes virtuais: `python -m venv venv`
 - Mantenha dependências atualizadas
 - Tokens GitHub devem ter permissões mínimas necessárias
-### Acesso a GitHub Models
+### Acesso aos GitHub Models
- Necessários Personal Access Tokens (PAT) para GitHub Models
+- São necessários tokens de acesso pessoal (PAT) para GitHub Models
- Tokens devem ser guardados como variáveis de ambiente
+- Armazene os tokens como variáveis de ambiente
- Nunca comite tokens ou credenciais
+- Nunca faça commit de tokens ou credenciais
 ## Notas Adicionais
@ -358,22 +358,22 @@ CO_OP_TRANSLATOR_METADATA:
 - Iniciantes completos em desenvolvimento web
 - Estudantes e autodidatas
- Professores a usar o currículo em salas de aula
+- Professores que usam o currículo em sala de aula
- Conteúdo desenhado para acessibilidade e desenvolvimento gradual de competências
+- Conteúdo desenhado para acessibilidade e construção gradual de competências
 ### Filosofia Educativa
- Abordagem baseada em projetos
+- Abordagem de aprendizagem baseada em projetos
- Verificações frequentes de conhecimento (quizzes)
+- Verificação frequente do conhecimento (quizzes)
 - Exercícios práticos de codificação
- Exemplos de aplicação no mundo real
+- Exemplos de aplicação real
 - Foco nos fundamentos antes dos frameworks
 ### Manutenção do Repositório
 - Comunidade ativa de aprendizes e contribuidores
 - Atualizações regulares de dependências e conteúdo
- Issues e discussões monitorizadas pelos mantenedores
+- Issues e discussões monitorizadas por mantenedores
 - Atualizações de tradução automatizadas via GitHub Actions
 ### Recursos Relacionados
@ -381,7 +381,7 @@ CO_OP_TRANSLATOR_METADATA:
 - [Módulos Microsoft Learn](https://docs.microsoft.com/learn/)
 - [Recursos do Student Hub](https://docs.microsoft.com/learn/student-hub/)
 - [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) recomendado para aprendizes
- Cursos adicionais: Currículos de IA Generativa, Ciência de Dados, ML, IoT disponíveis
+- Cursos adicionais: AI Generativa, Ciência de Dados, ML, IoT disponíveis
 ### Trabalhar com Projetos Específicos
@ -389,20 +389,20 @@ Para instruções detalhadas sobre projetos individuais, consulte os ficheiros R
 - `quiz-app/README.md` - Aplicação de quiz Vue 3
 - `7-bank-project/README.md` - Aplicação bancária com autenticação
 - `5-browser-extension/README.md` - Desenvolvimento de extensão de navegador
- `6-space-game/README.md` - Desenvolvimento de jogo em Canvas
+- `6-space-game/README.md` - Desenvolvimento de jogo em canvas
- `9-chat-project/README.md` - Projeto assistente de chat IA
+- `9-chat-project/README.md` - Projeto de assistente de chat IA
 ### Estrutura Monorepo
 Embora não seja um monorepo tradicional, este repositório contém múltiplos projetos independentes:
- Cada lição é autónoma
+- Cada lição é autocontida
 - Projetos não partilham dependências
- Trabalhe em projetos individuais sem afetar os outros
+- Trabalhe em projetos individuais sem afetar outros
- Clone o repositório completo para a experiência total do currículo
+- Clone todo o repositório para a experiência completa do currículo
 ---
 <!-- CO-OP TRANSLATOR DISCLAIMER START -->
 **Aviso Legal**:  
-Este documento foi traduzido utilizando o serviço de tradução automática [Co-op Translator](https://github.com/Azure/co-op-translator). Embora nos esforcemos pela precisão, esteja ciente de que traduções automáticas podem conter erros ou imprecisões. O documento original na sua língua nativa deve ser considerado a fonte autoritativa. Para informações críticas, recomenda-se a tradução profissional por humanos. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações erradas decorrentes do uso desta tradução.
+Este documento foi traduzido utilizando o serviço de tradução automática [Co-op Translator](https://github.com/Azure/co-op-translator). Embora nos esforcemos pela precisão, esteja ciente de que traduções automáticas podem conter erros ou imprecisões. O documento original na sua língua nativa deve ser considerado a fonte oficial. Para informações críticas, recomenda-se tradução profissional humana. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações erradas decorrentes do uso desta tradução.
 <!-- CO-OP TRANSLATOR DISCLAIMER END -->