Web-Dev-For-Beginners/translations/kn/AGENTS.md

# AGENTS.md

## ಪ್ರಾಜೆಕ್ಟ್ ಅವಲೋಕನ

ಇದು ಆರಂಭಿಕರಿಗೆ ವೆಬ್ ಅಭಿವೃದ್ಧಿಯ ಮೂಲತತ್ತ್ವಗಳನ್ನು ಕಲಿಸಲು শিক্ষಾ ಪಠ್ಯಕ್ರಮದ ರೆಪಾಸಿಟರಿ. ಈ ಪಠ್ಯಕ್ರಮವು Microsoft Cloud Advocates ತಂಡದಿಂದ ಅಭಿವೃದ್ಧಿಪಡಿಸಿದ ಸಂಪೂಟ 12-ವಾರಗಳ ಕೋರ್ಸ್ ಆಗಿದ್ದು, ಜಾವಸ್ಕ್ರಿಪ್ಟ್, CSS ಮತ್ತು HTML ಅನ್ನು ಒಳಗೊಂಡ 24 ಕೈಗೆ ಒಳಗಾದ ಪಾಠಗಳನ್ನು ಒಳಗೊಂಡಿದೆ.

### ಪ್ರಮುಖ ಘಟಕಗಳು

- **ಶಿಕ್ಷಣಾತ್ಮಕ ವಿಷಯ**: ಯೋಜನೆ ಆಧಾರಿತ ಘಟಕಗಳಾಗಿ 24 ವಿನ್ಯಾಯಿತ ಪಾಠಗಳು  
- **ಪ್ರಾಯೋಗಿಕ ಯೋಜನೆಗಳು**: ಟೆರರಿಯಂ, ಟೈಪಿಂಗ್ ಆಟ, ಬ್ರೌಸರ್ ವಿಸ್ತರಣೆ, ಸ್ಥಳದ ಆಟ, ಬ್ಯಾಂಕಿಂಗ್ ಅಪ್ಲಿಕೇಶನ್, ಕೋಡ್ ಎಡಿಟರ್ ಮತ್ತು AI ಚಾಟ್ ಸಹಾಯಕ  
- **ಪರಸ್ಪರ ಕ್ರಿಯಾಶೀಲ ಕ್ವಿಜ್‌ಗಳು**: ಪ್ರತಿ ಒಂದು ಕ್ವಿಜ್‌ಗೆ 3 ಪ್ರಶ್ನೆಗಳ ಕಾಲ 48 ಕ್ವಿಜ್‌ಗಳು (ಪಾಠಕ್ಕೆ ಮುಂಚಿನ/ನಂತರದ ಮೌಲ್ಯಮಾಪನ)  
- **ಬಹುಭಾಷಾ ಬೆಂಬಲ**: GitHub Actions ಮೂಲಕ 50+ ಭಾಷೆಗಳಿಗೆ ಸ್ವಯಂಚಾಲಿತ ಅನುವಾದ  
- **ತಂತ್ರಜ್ಞಾನಗಳು**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI ಯೋಜನೆಗಳಿಗೆ)

### ಶಿಲ್ಪವಿಧಾನ

- ಪಾಠ ಆಧಾರಿತ ರಚನೆಯೊಂದಿಗೆ ಶಿಕ್ಷಣ ರೆಪಾಸಿಟರಿ  
- ಪ್ರತಿ ಪಾಠದ ಫೋಲ್ಡರ್ ಗೆ README, ಕೋಡ್ ಉದಾಹರಣೆಗಳು ಮತ್ತು ಪರಿಹಾರಗಳು  
- ವಿಭಿನ್ನ ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ ಸ್ವತಂತ್ರ ಯೋಜನೆಗಳು (quiz-app, ವಿವಿಧ ಪಾಠ ಯೋಜನೆಗಳು)  
- GitHub Actions ಬಳಸಿ ಅನುವಾದ ವ್ಯವಸ್ಥೆ (co-op-translator)  
- Docsify ಮೂಲಕ ಡಾಕ್ಯುಮೆಂಟೇಶನ್ ವಿತರಣೆ ಮತ್ತು PDF ರೂಪದಲ್ಲಿ ಲಭ್ಯವಿದೆ

## ಸೆಟಪ್ ಕಮಾಂಡುಗಳು

ಈ ರೆಪಾಸಿಟರಿ ಮುಖ್ಯವಾಗಿ ಶಿಕ್ಷಣಕ್ಕಾಗಿ ವಿಷಯ ಸೇವೆಗೆ. ನಿರ್ದಿಷ್ಟ ಯೋಜನೆಗಳ ಜೊತೆಗೆ ಕೆಲಸ ಮಾಡಲು:

### ಮುಖ್ಯ ರೆಪಾಸಿಟರಿ ಸೆಟಪ್

```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners
```

### ಕ್ವಿಜ್ ಅಪ್ ಸೆಟಪ್ (Vue 3 + Vite)

```bash
cd quiz-app
npm install
npm run dev        # ಅಭಿವೃದ್ಧಿ ಸರ್ವರ್ ಪ್ರಾರಂಭಿಸಿ
npm run build      # ಉತ್ಪಾದನೆಯಿಗಾಗಿ ನಿರ್ಮಿಸಿ
npm run lint       # ESLint ನಡೆಸಿ
```

### ಬ್ಯಾಂಕಿಂಗ್ ಯೋಜನೆ API (Node.js + Express)

```bash
cd 7-bank-project/api
npm install
npm start          # ಎಪಿಐ ಸರ್ವರ್ ಪ್ರಾರಂಭಿಸಿ
npm run lint       # ESLint ಅನ್ನು ರನ್ ಮಾಡಿ
npm run format     # prettier ಮೂಲಕ ಫಾರ್ಮ್ಯಾಟ್ ಮಾಡಿ
```

### ಬ್ರೌಸರ್ ವಿಸ್ತರಣೆ ಯೋಜನೆಗಳು

```bash
cd 5-browser-extension/solution
npm install
# ಬ್ರೌಸರ್-ನಿರ್ದಿಷ್ಟ ವಿಸ್ತರಣೆ ಲೋಡ್‌ ಮಾಡಲು ಸೂಚನೆಗಳನ್ನು ಅನುಸರಿಸಿ
```

### ಸ್ಥಳದ ಆಟ ಯೋಜನೆಗಳು

```bash
cd 6-space-game/solution
npm install
# ಬ್ರೌಸರ್‌ನಲ್ಲಿ index.html ತೆರೆಯಿರಿ ಅಥವಾ ಲೈವ್ ಸರ್ವರ್ ಬಳಸಿರಿ
```

### ಚಾಟ್ ಯೋಜನೆ (Python ಬ್ಯಾಕೆಂಡ್)

```bash
cd 9-chat-project/solution/backend/python
pip install openai
# GITHUB_TOKEN ಪರಿಸರ ಚರವನ್ನು ಸೆಟ್ ಮಾಡಿ
python api.py
```

## ಅಭಿವೃದ್ಧಿ ಕೆಲಸದ ಪ್ರವಾಹ

### ವಿಷಯ ಕೊಡುಗೆದಾರರಿಗಾಗಿ

1. **ರೆಪಾಸಿಟರಿಯನ್ನು ಫೋರ್ಕ್ ಮಾಡಿ** ನಿಮ್ಮ GitHub ಖಾತೆಗೆ  
2. **ಫೋರ್ಕ್ ಅನ್ನು ಸ್ಥಳೀಯವಾಗಿ ಕ್ಲೋನ್ ಮಾಡಿ**  
3. **ನಿಮ್ಮ ಬದಲಾವಣೆಗಳಿಗಾಗಿ ಹೊಸ ಶಾಖೆಯನ್ನು ಮಾಡಿ**  
4. ಪಾಠ ವಿಷಯ ಅಥವಾ ಕೋಡ್ ಉದಾಹರಣೆಗಳಲ್ಲಿ ಬದಲಾವಣೆ ಮಾಡಿ  
5. ಸಂಬಂಧಿತ ಯೋಜನೆ ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ ಯಾವುದೇ ಕೋಡ್ ಬದಲಾವಣೆಗಳನ್ನು ಪರೀಕ್ಷಿಸಿ  
6. ಕೊಡುಗೆ ಮಾರ್ಗಸೂಚಿಗಳಂತೆ ಪુલ್ ರಿಕ್ವೆಸ್ಟ್ ಸಲ್ಲಿಸಿ

### ಕಲಿಯುವವರಿಗಾಗಿ

1. ರೆಪಾಸಿಟರಿಯನ್ನು ಫೋರ್ಕ್ ಅಥವಾ ಕ್ಲೋನ್ ಮಾಡಿ  
2. ಸರಣಿಯಲ್ಲಿ ಪಾಠ ಡೈರೆಕ್ಟರಿಗಳಿಗೆ ನವಿಗೇಟ್ ಮಾಡಿ  
3. ಪ್ರತಿ ಪಾಠದ README ಫೈಲ್ ಓದಿ  
4. ಮುಂಚಿನ ಪಾಠದ ಕ್ವಿಜ್‌ಗಳನ್ನು https://ff-quizzes.netlify.app/web/ ನಲ್ಲಿ ಪೂರೈಸಿ  
5. ಪಾಠ ಫೋಲ್ಡರ್‌ಗಳಲ್ಲಿ ಕೋಡ್ ಉದಾಹರಣೆಗಳ ಮೂಲಕ ಕೆಲಸ ಮಾಡಿ  
6. ಕಾರ್ಯಗಳನ್ನು ಮತ್ತು ಸವಾಲುಗಳನ್ನು ಪೂರ್ಣಗೊಳಿಸಿ  
7. ನಂತರದ ಪಾಠದ ಕ್ವಿಜ್‌ಗಳನ್ನು ತೆಗೆದುಕೊಳ್ಳಿ

### ప్రత్యಕ್ಷ ಅಭಿವೃದ್ಧಿ

- **ಡಾಕ್ಯುಮೆಂಟೇಶನ್**: ರೂಟ್‌ನಲ್ಲಿ `docsify serve` ರನ್ ಮಾಡಿ (ಪೋರ್ಟ್ 3000)  
- **ಕ್ವಿಜ್ ಅಪ್**: `quiz-app` ಡೈರೆಕ್ಟರಿಯಲ್ಲಿ `npm run dev` ರನ್ ಮಾಡಿ  
- **ಯೋಜನೆಗಳು**: HTML ಯೋಜನೆಗಳಿಗೆ VS Code Live Server ವಿಸ್ತರಣೆ ಬಳಸಿ  
- **API ಯೋಜನೆಗಳು**: ಸಂಬಂಧಿತ API ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ `npm start` ರನ್ ಮಾಡಿ

## ಪರೀಕ್ಷೆ ಸೂಚನೆಗಳು

### ಕ್ವಿಜ್ ಅಪ್ ಪರೀಕ್ಷೆ

```bash
cd quiz-app
npm run lint       # ಕೋಡ್ ಶೈಲಿ ಸಮಸ್ಯೆಗಳನ್ನು ಪರಿಶೀಲಿಸಿ
npm run build      # ನಿರ್ಮಾಣ ಯಶಸ್ವಿಯಾಗಿದೆಯೇ ಎಂದು ಪರಿಶೀಲಿಸಿ
```

### ಬ್ಯಾಂಕ್ API ಪರೀಕ್ಷೆ

```bash
cd 7-bank-project/api
npm run lint       # ಕೋಡ್ ಶೈಲಿ ಸಮಸ್ಯೆಗಳಿಗಾಗಿ ಪರಿಶೀಲಿಸಿ
node server.js     # ಸರ್ವರ್ ಎರರ್ ಇಲ್ಲದೆ ಪ್ರಾರಂಭವಾಗುತ್ತದೆಯಾ ಎಂದು ಪರಿಶೀಲಿಸಿ
```

### ಸಾಮಾನ್ಯ ಪರೀಕ್ಷಾ ವಿಧಾನ

- ಇದು ಸಂಪೂರ್ಣ ಸ್ವಯಂಚಾಲಿತ ಪರೀಕ್ಷೆಗಳುಳ್ಳ ಶಿಕ್ಷಣ ರೆಪಾಸಿಟರಿ ಅಲ್ಲ  
- ಕೈಯಿಂದ ಪರೀಕ್ಷಿಸುವುದು ಮುಖ್ಯ:
  - ಕೋಡ್ ಉದಾಹರಣೆಗಳು ದೋಷವಿಲ್ಲದೆ ನಡೆಯುವುದು  
  - ಡಾಕ್ಯುಮೆಂಟೇಶನ್‌ನ ಲಿಂಕುಗಳು ಸರಿಯಾಗಿ ಕೆಲಸ ಮಾಡುವುದು  
  - ಪ್ರಾಜೆಕ್ಟ್ ನಿರ್ಮಾಣ ಯಶಸ್ವಿಯಾಗಿದೆ  
  - ಉದಾಹರಣೆಗಳು ಉತ್ತಮ ಕ್ರಮಗಳು ಅನುಸರಿಸುತ್ತವೆ

### ಸಲ್ಲಿಸುವ ಮೊದಲು ಪರಿಶೀಲನೆಗಳು

- package.json ಇರುವ ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ `npm run lint` ರನ್ ಮಾಡಿ  
- ಮಾರ್ಕ್‌ಡೌನ್ ಲಿಂಕುಗಳು ಮಾನ್ಯವೇ ಎಂದು ಪರಿಶೀಲಿಸಿ  
- ಕೋಡ್ ಉದಾಹರಣೆಗಳನ್ನು ಬ್ರೌಸರ್ ಅಥವಾ Node.js ನಲ್ಲಿ ಪರೀಕ್ಷಿಸಿ  
- ಅನುವಾದಗಳು ಸರಿಯಾದ ರಚನೆ ಕಾಪಾಡುತ್ತವೆಂದು ಪರಿಶೀಲಿಸಿ

## ಕೋಡ್ ಶೈಲಿ ಮಾರ್ಗಸೂಚಿಗಳು

### ಜಾವಸ್ಕ್ರಿಪ್ಟ್

- ಆಧುನಿಕ ES6+ ಸಂರಚನೆಯನ್ನು ಬಳಸಿ  
- ಪ್ರಾಜೆಕ್ಟುಗಳಲ್ಲಿ ನೀಡಲಾದ ಮಾನಕ ESLint ನಿಘಂಟುಗಳನ್ನು ಅನುಸರಿಸಿ  
- ಶಿಕ್ಷಣ ಸ್ಪಷ್ಟತೆಗೆ ಅರ್ಥಪೂರ್ಣ ವ್ಯತ್ಯಾಸಿಕೆ ಮತ್ತು ಫಂಕ್ಷನ್ ಹೆಸರುಗಳನ್ನು ಬಳಸಿ  
- ಕಲಿಯುವವರಿಗೆ ಕಲಿಕೆಗಾಗಿ ಕಾಮೆಂಟ್‌ಗಳು ಸೇರಿಸಿ  
- ಹೊಂದಿಗೊಳಿಸಿದ Prettier ಬಳಸಿ ಸ್ವರೂಪಣೆಯಾಗಿ ಫಾರ್ಮ್ಯಾಟ್ ಮಾಡಿ

### HTML/CSS

- ಅರ್ಥಪೂರ್ಣ HTML5 ಅಂಶಗಳು  
- ಪ್ರತಿಕ್ರಿಯಾಶೀಲ ವಿನ್ಯಾಸ ತತ್ವಗಳು  
- ಸ್ಪಷ್ಟ ಕ್ಲಾಸ್ ಹೆಸರು ನಿಯಮಗಳು  
- CSS ತಂತ್ರಗಳನ್ನು ಕಲಿಯುವವರಿಗೆ ವಿವರಿಸುವ ಕಾಮೆಂಟ್‌ಗಳು

### ಪೈಥಾನ್

- PEP 8 ಶೈಲಿ ಮಾರ್ಗಸೂಚಿಗಳು  
- ಸ್ವಚ್ಚ, ಶಿಕ್ಷಣಾತ್ಮಕ ಕೋಡ್ ಉದಾಹರಣೆಗಳು  
- ಕಲಿಕೆಯ ಸರಿಗೆ ಉಚಿತ ಟೈಪಿಂಗ್ ಸೂಚನೆಗಳು

### ಮಾರ್ಕ್‌ಡೌನ್ ಡಾಕ್ಯುಮೆಂಟೇಶನ್

- ಸ್ಪಷ್ಟ ಶೀರ್ಷಿಕೆ ಹಿರarchicalತೆ  
- ಭಾಷಾ ಪಾರದರ್ಶಕತೆ ಸಹಿತ ಕೋಡ್ ಬ್ಲಾಕ್‌ಗಳು  
- ಹೆಚ್ಚುವರಿ ಸಂಪನ್ಮೂಲಗಳಿಗೆ ಲಿಂಕುಗಳು  
- `images/` ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ ಸ್ಕ್ರೀನ್‌ಶಾಟ್ ಮತ್ತು ಚಿತ್ರಗಳು  
- ಪ್ರಾಪ್ಯತೆಗಾಗಿ ಚಿತ್ರಗಳಿಗೆ_ALT_ ಪಠ್ಯ

### ಫೈಲ್ ಸಂಘಟನೆ

- ಪಾಠಗಳು ಕ್ರಮಕ್ರಮವಾಗಿ ಸಂಖ್ಯೆಮಾಡಲ್ಪಟ್ಟಿವೆ (1-getting-started-lessons, 2-js-basics, ಇತ್ಯಾದಿ)  
- ಪ್ರತಿ ಯೋಜನೆಯಲ್ಲಿ `solution/` ಮತ್ತು ಬಹುಮಾನವಾಗಿ `start/` ಅಥವಾ `your-work/` ಡೈರೆಕ್ಟರಿಗಳು ಇವೆ  
- ಚಿತ್ರಗಳನ್ನು ಪಾಠ-ನಿರ್ದಿಷ್ಟ `images/` ಫೋಲ್ಡರ್ಗಳು ಇಟ್ಟುಕೊಂಡಿವೆ  
- ಅನುವಾದಗಳನ್ನು `translations/{language-code}/` ರಚನೆಯಲ್ಲಿ ಇಡಲಾಗುತ್ತದೆ

## ನಿರ್ಮಾಣ ಮತ್ತು ನಿಯೋಜನೆ

### ಕ್ವಿಜ್ ಅಪ್ ನಿಯೋಜನೆ (Azure Static Web Apps)

ಕ್ವಿಜ್-ಅಪ್ Azure Static Web Apps ನಿಯೋಜನೆಗೆ ವ್ಯವಸ್ಥಾಪಿತವಾಗಿದೆ:

```bash
cd quiz-app
npm run build      # dist/ ಫೋಲ್ಡರ್ ರಚಿಸುತ್ತದೆ
# ಮುಖ್ಯ ಶಾಖೆಗೆ ಪುಷ್ ಮಾಡಿದಾಗ GitHub Actions ಕೆಲಸಪ್ರಕ್ರಿಯೆಯ ಮೂಲಕ ನಿಯೋಜಿಸುತ್ತದೆ
```

Azure Static Web Apps ಸಂರಚನೆ:
- **ಆ್ಯಪ್ ಸ್ಥಳ:** `/quiz-app`  
- **ನಿರ್ಗಮನ ಸ್ಥಳ:** `dist`  
- **ಕಾರ್ಯಪ್ರವಾಹ:** `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`

### ಡಾಕ್ಯುಮೆಂಟೇಶನ್ PDF ತಯಾರಿಕೆ

```bash
npm install                    # docsify-to-pdfನ್ನು ಸ್ಥಾಪಿಸಿ
npm run convert               # ಡಾಕ್ಗಳಿಂದ PDF ರಚಿಸಿ
```

### ಡಾಕ್ಸಿಫೈ ಡಾಕ್ಯುಮೆಂಟೇಶನ್

```bash
npm install -g docsify-cli    # Docsify ಅನ್ನು ಗ್ಲೋಬಲ್ ಆಗಿ ಇನ್‌ಸ್ಟಾಲ್ ಮಾಡಿ
docsify serve                 # localhost:3000 ನಲ್ಲಿ ಸರ್ವ್ ಮಾಡಿ
```

### ಪ್ರಾಜೆಕ್ಟ್-ಸ್ಪಷ್ಟ ನಿರ್ಮಾಣಗಳು

ಪ್ರತಿ ಪ್ರಾಜೆಕ್ಟ್ ಡೈರೆಕ್ಟರಿಗೆ ತನ್ನದೇನ್ ನಿರ್ಮಾಣ ಪ್ರಕ್ರಿಯೆಯಿರಬಹುದು:  
- Vue ಪ್ರಾಜೆಕ್ಟುಗಳು: `npm run build` ರನ್ ಮಾಡಿ ಉತ್ಪಾದನಾ ಬಂಡಲ್‌ಗಳನ್ನು ಸೃಷ್ಟಿಸಿ  
- ಸ್ಥಿರ ಪ್ರಾಜೆಕ್ಟುಗಳು: ಯಾವುದೇ ನಿರ್ಮಾಣ ಹಂತವಿಲ್ಲ, ಫೈಲ್‌ಗಳನ್ನು ನೇರವಾಗಿ ಸೇವ್ ಮಾಡುತ್ತದೆ

## ಪულ್ ರಿಕ್ವೆಸ್ಟ್ ಮಾರ್ಗಸೂಚಿಗಳು

### ಶೀರ್ಷಿಕೆ ಮಾದರಿ

ಬದಲಾವಣೆ ಪ್ರದೇಶದ ಸ್ಪಷ್ಟ, ವಿವರಣಾತ್ಮಕ ಶೀರ್ಷಿಕೆಗಳನ್ನು ಬಳಸಿ:  
- `[Quiz-app] ಪಾಠ X ಗೆ ಹೊಸ ಕ್ವಿಜ್ ಸೇರಿಸಲಾಗಿದೆ`  
- `[Lesson-3] ಟೆರರಿಯಮ್ ಯೋಜನೆಯಲ್ಲಿ ಟೈಪೋ ಸರಿಪಡಿಸಲಾಗಿದೆ`  
- `[Translation] ಪಾಠ 5ಕ್ಕೆ ಸ್ಪ್ಯಾನಿಷ್ ಅನುವಾದವನ್ನು ಸೇರಿಸಲಾಗಿದೆ`  
- `[Docs] ಸೆಟಪ್ ಸೂಚನೆಗಳನ್ನು ನವೀಕರಿಸಲಾಗಿದೆ`

### ಅಗತ್ಯ ಪರಿಶೀಲನೆಗಳು

PR ಸಲ್ಲಿಸುವ ಮೊದಲು:  

1. **ಕೋಡ್ ಗುಣಮಟ್ಟ**:  
   - ಸಂಬಂಧಿತ ಪ್ರಾಜೆಕ್ಟ್ ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ `npm run lint` ರನ್ ಮಾಡಿ  
   - ಎಲ್ಲಾ ಲಿಂಟ್ ದೋಷಗಳ ಮತ್ತು ಎಚ್ಚರಿಕೆಗಳನ್ನು ಸರಿಪಡಿಸಿ

2. **ನಿರ್ಮಾಣ ಪರಿಶೀಲನೆ**:  
   - ಅನ್ವಯವಾಗುವಲ್ಲಿ `npm run build` ರನ್ ಮಾಡಿ  
   - ಯಾವುದೇ ನಿರ್ಮಾಣ ದೋಷಗಳಿಲ್ಲವೆಂದು ಖಚಿತಪಡಿಸಿ

3. **ಲಿಂಕ್ ಪರಿಶೀಲನೆ**:  
   - ಎಲ್ಲಾ ಮಾರ್ಕ್‌ಡೌನ್ ಲಿಂಕುಗಳನ್ನು ಪರೀಕ್ಷಿಸಿ  
   - ಚಿತ್ರ ಉಲ್ಲೇಖಗಳು ಕಾರ್ಯನಿರ್ವಹಿಸುತ್ತವೆಯೇ ಎಂದು ಖಚಿತಪಡಿಸಿ

4. **ವಿಷಯ ವಿಮರ್ಶೆ**:  
   - ವಚನಮಾಲಿಕೆಯಲ್ಲಿ ಸೂಕ್ತತೆ ಪರಿಶೀಲಿಸಿ  
   - ಕೋಡ್ ಉದಾಹರಣೆಗಳು ಸರಿಯಾಗಿದೆ ಮತ್ತು ಶೈಕ್ಷಣಿಕವಾಗಿವೆ ಎಂದು ಖಚಿತಪಡಿಸಿ  
   - ಅನುವಾದಗಳು ಮೂಲ ಅರ್ಥವನ್ನು ಕಾಪಾಡಿಕೊಳ್ಳುತ್ತವೆ ಎಂದು ಪರಿಶೀಲಿಸಿ

### ಕೊಡುಗೆ ಅಗತ್ಯತೆಗಳು

- Microsoft CLA ಗೆ ಸಮ್ಮತಿ ನೀಡಿ (ಮೊದಲ PR ಮೇಲೆ ಸ್ವಯಂಚಾಲಿತ ಪರಿಶೀಲನೆ)  
- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) ಅನುಸರಿಸಿ  
- ವಿಶದ ಮಾರ್ಗಸೂಚಿಗಾಗಿ [CONTRIBUTING.md](./CONTRIBUTING.md) ನೋಡಿ  
- ಯೋಜಿತ ಸಮಸ್ಯೆಗಳ ಸಂಖ್ಯೆಯನ್ನು PR ವಿವರಣೆಯಲ್ಲಿ ಉಲ್ಲೇಖಿಸಿ

### ವಿಮರ್ಶಾ ಪ್ರಕ್ರಿಯೆ

- PRಗಳನ್ನು ನಿರ್ವಹಕರು ಮತ್ತು ಸಮುದಾಯ ವಿಮರ್ಶೆ ಮಾಡುತ್ತಾರೆ  
- ಶಿಕ್ಷಣ ಸ್ಪಷ್ಟತೆ ಅವರನ್ನು ಆದ್ಯತೆ  
- ಕೋಡ್ ಉದಾಹರಣೆಗಳು ಇತ್ತೀಚಿನ ಉತ್ತಮ ಕ್ರಮಗಳು ಅನುಸರಿಸಬೇಕು  
- ಅನುವಾದಗಳನ್ನು ಶುದ್ಧತೆ ಮತ್ತು ಸಾಂಸ್ಕೃತಿಕ ಅನುಕೂಲತೆಗಾಗಿ ಪರಿಗಣಿಸಲಾಗುತ್ತದೆ

## ಅನುವಾದ ವ್ಯವಸ್ಥೆ

### ಸ್ವಯಂಚಾಲಿತ ಅನುವಾದ

- GitHub Actions ಮತ್ತು co-op-translator workflow ಬಳಸಿ  
- 50+ ಭಾಷೆಗಳಿಗೆ ಸ್ವಯಂಚಾಲಿತ ಅನುವಾದ  
- ಮೂಲ ಫೈಲ್‌ಗಳು ಮುಖ್ಯ ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿವೆ  
- ಅನುವಾದಿತ ಫೈಲ್‌ಗಳು `translations/{language-code}/` ರಚನೆಯಲ್ಲಿ ಇವೆ

### ಕೈಯಲ್ಲಿ ಅನುವಾದ ಸುಧಾರಣೆ ಸೇರಿಸುವುದು

1. `translations/{language-code}/` ನಲ್ಲಿ ಫೈಲ್ ಹುಡುಕಿ  
2. ರಚನೆಯನ್ನು ಉಳಿಸಿಕೊಂಡು ಸುಧಾರಣೆ ಮಾಡಲು  
3. ಕೋಡ್ ಉದಾಹರಣೆಗಳು ಕಾರ್ಯನಿರ್ವಹಿಸುತ್ತವೆ ಎಂದು ಖಚಿತಪಡಿಸಲು  
4. ಸ್ಥಳೀಯ ಕ್ವಿಜ್ ವಿಷಯವನ್ನು ಪರೀಕ್ಷಿಸಿ

### ಅನುವಾದ ಮೆಟಾಡೇಟಾ

ಅನುವಾದಿತ ಫೈಲ್‌ಗಳ ಮುಂಭಾಗದಲ್ಲಿ ಮೆಟಾಡೇಟಾ ಅಂಶಗಳನ್ನು ಒಳಗೊಂಡಿದೆ:  
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
{
  "original_hash": "...",
  "translation_date": "...",
  "source_file": "...",
  "language_code": "..."
}
-->
```

## ದೋಷಶೋಧನೆ ಮತ್ತು ಸಮಸ್ಯೆ ಪರಿಹಾರ

### ಸಾಮಾನ್ಯ ಸಮಸ್ಯೆಗಳು

**ಕ್ವಿಜ್ ಅಪ್ ಆರಂಭಿಸಲು ವಿಫಲವಾಗಿದೆ**:  
- Node.js ಆವೃತ್ತಿ (v14+ ಶಿಫಾರಸು) ಪರಿಶೀಲಿಸಿ  
- `node_modules` ಮತ್ತು `package-lock.json` ಅಳಿಸಿ, ಮತ್ತೆ `npm install` ರನ್ ಮಾಡಿ  
- ಪೋರ್ಟ್ ಸಂಘರ್ಷಗಳನ್ನು ಪರಿಶೀಲಿಸಿ (ಪೂರ್ವನಿಯೋಜಿತ: Vite ಪೋರ್ಟ್ 5173 ಬಳಸುತ್ತದೆ)

**API ಸರ್ವರ್ ಆರಂಭಿಸೋದಿಲ್ಲ**:  
- Node.js ಆವೃತ್ತಿ ಕಡಿಮೆ ಆಗಿರಬಾರದು (node >=10)  
- ಪೋರ್ಟ್ ಬಳಕೆಯಲ್ಲದಿರುವುದನ್ನು ಪರಿಶೀಲಿಸಿ  
- ಎಲ್ಲಾ ಅವಲಂಬನೆಗಳು ಇನ್‌ಸ್ಟಾಲ್ ಆಗಿವೆ ಎಂದು ಖಚಿತಪಡಿಸಿ `npm install` ಮೂಲಕ

**ಬ್ರೌಸರ್ ವಿಸ್ತರಣೆ ಲೋಡ್ ಆಗೋದಿಲ್ಲ**:  
- manifest.json ಸರಿಯಾದ ಸ್ವರೂಪದಲ್ಲಿದೆಯೇ ಎಂದು ಪರಿಶೀಲಿಸಿ  
- ಬ್ರೌಸರ್ ಕಾಂಸೋಲ್ ದೋಷಗಳು ಹೇಗಿವೆ ಎಂಬುದನ್ನು ಪರಿಶೀಲಿಸಿ  
- ಬ್ರೌಸರ್-ನಿರ್ದಿಷ್ಟ ವಿಸ್ತರಣೆ ಸ್ಥಾಪನೆ ಸೂಚನೆಗಳು ಅನುಸರಿಸಿ

**Python ಚಾಟ್ ಯೋಜನೆ ಸಮಸ್ಯೆಗಳು**:  
- OpenAI ಪ್ಯಾಕೇಜ್ ಇನ್‌ಸ್ಟಾಲ್ ಮಾಡಿ: `pip install openai`  
- GITHUB_TOKEN ಪರಿಸರ ಚರ ಇನ್‌ಸ್ಟಾಲ್ ಆಗಿದೆ ಎಂದು ಖಚಿತಪಡಿಸಿ  
- GitHub Models ಪ್ರವೇಶ ಪರವಾನಿಗೆಗಳನ್ನು ಪರಿಶೀಲಿಸಿ

**Docsify ಡಾಕ್ಯುಮೆಂಟೇಶನ್ ನೀಡಲಾಗುತ್ತಿಲ್ಲ**:  
- globallu docsify-cli ಇನ್‌ಸ್ಟಾಲ್ ಮಾಡಿ: `npm install -g docsify-cli`  
- ರೆಪಾಸಿಟರಿಯ ರೂಟ್ ಡೈರೆಕ್ಟರಿಯಿಂದ ರನ್ ಮಾಡಿ  
- `docs/_sidebar.md` ಇದ್ದು ಇರುವುದನ್ನು ಪರಿಶೀಲಿಸಿ

### ಅಭಿವೃದ್ಧಿ ಪರಿಸರ ಸಲಹೆಗಳು

- HTML ಯೋಜನೆಗಳಿಗೆ VS Code Live Server ವಿಸ್ತರಣೆ ಬಳಸಿರಿ  
- ಓರ್ವ ESLint ಮತ್ತು Prettier ವಿಸ್ತರಣೆಗಳನ್ನು ಸ್ಥಾಪಿಸಿ ನಿರಂತರ ಸ್ವರೂಪಣೆಗೆ  
- ಜಾವಾ ಸ್ಕ್ರಿಪ್ಟ್ ದೋಷ ಶೋಧಿಸಲು ಬ್ರೌಸರ್ ಡೆವ್ ಟೂಲ್ಗಳು ಬಳಸಿರಿ  
- Vue ಯೋಜನೆಗಳಿಗೆ Vue DevTools ಬ್ರೌಸರ್ ವಿಸ್ತರಣೆ ಸ್ಥಾಪಿಸಿ

### ಕಾರ್ಯಕ್ಷಮತೆ ಪರಿಗಣನೆ

- ಅನೇಕ ಅನುವಾದಿತ ಫೈಲ್‌ಗಳು (50+ ಭಾಷೆಗಳು) ಇರುವುದು ಸಂಪೂರ್ಣ ಕ್ಲೋನ್‌ಗಳ ಪ್ರಮಾಣವನ್ನು ಹೆಚ್ಚಿಸುತ್ತದೆ  
- ವಿಷಯದ ಮೇಲೆ ಮಾತ್ರ ಕೆಲಸ ಮಾಡುವಾಗ `git clone --depth 1` ಮೂಲಕ ತಳಮಟ್ಟದ ಕ್ಲೋನ್ ಉಪಯೋಗಿಸಿ  
- ಇಂಗ್ಲಿಷ್ ವಿಷಯಕ್ಕೆ ಸಂಬಂಧಿಸಿದ ಹುಡುಕಾಟಗಳಲ್ಲಿ ಅನುವಾದಗಳನ್ನು ഒഴിവುಮಾಡಿ  
- ನಿರ್ಮಾಣ ಪ್ರಕ್ರಿಯೆಗಳು ಮೊದಲ ರನ್‌ನಲ್ಲಿ ನಿಧಾನವಾಗಬಹುದು (`npm install`, Vite ನಿರ್ಮಾಣ)

## ಭದ್ರತಾ ಪರಿಗಣನೆಗಳು

### ಪರಿಸರ ಚರ

- API ಕೀಲಿಗಳನ್ನು ರೆಪಾಸಿಟರಿಯಲ್ಲಿ ಬಿಗ್‌ಪಡಿಸಬಾರದು  
- `.env` ಫೈಲ್‌ಗಳನ್ನು ಬಳಸಿ (ಹಾಗೂ `.gitignore` ಒಳಗೊಂಡಿದೆ)  
- ಅಗತ್ಯವಿರುವ ಪರಿಸರ ಚರಗಳನ್ನು ಪ್ರಾಜೆಕ್ಟ್ READMEಗಳಲ್ಲಿ ದಾಖಲೆ ಮಾಡಿ

### Python ಯೋಜನೆಗಳು

- ವರ್ಚುವಲ್ ಪರಿಸರ ಬಳಸಿ: `python -m venv venv`  
- ಅವಲಂಬನೆಗಳನ್ನು ನವೀಕರಿಸಿ  
- GitHub ಟೋಕನ್ಗಳು ಕನಿಷ್ಟ ಅಗತ್ಯ ಪರವಾನಿಗೆಗಳಿರಲಿ

### GitHub Models ಪ್ರವೇಶ

- GitHub Models ಗಾಗಿ Personal Access Tokens (PAT) ಅಗತ್ಯ  
- ಟೋಕನ್‌ಗಳನ್ನು ಪರಿಸರ ಚರಗಳಾಗಿ ಸಂರಕ್ಷಿಸಿ  
- ಟೋಕನ್‌ಗಳು ಅಥವಾ ಪ್ರಮಾಣಪತ್ರಗಳನ್ನು ಕಡ್ಡಾಯವಾಗಿ ಕಮಿಟ್ ಮಾಡಬಾರದು

## ಹೆಚ್ಚುವರಿ ಟಿಪ್ಪಣಿಗಳು

### ಗುರಿ ಪ್ರೇಕ್ಷಕ

- ವೆಬ್ ಅಭಿವೃದ್ಧಿಯ ಸಂಪೂರ್ಣ ಆರಂಭಿಕರು  
- ವಿದ್ಯಾರ್ಥಿಗಳು ಮತ್ತು ಸ್ವಯಂ ಅಧ್ಯಯನದವರು  
- ತರಗತಿಗಳಲ್ಲಿ ಪಠ್ಯಕ್ರಮ ಬಳಸುವ ಶಿಕ್ಷಕರು  
- ಪ್ರವೇಶ್ಯತೆ ಮತ್ತು ಹಗ್ಗದ ಕೌಶಲ್ಯ ನಿರ್ಮಾಣಕ್ಕಾಗಿ ವಿನ್ಯಾಸಗೊಳಿಸಲಾಗಿದೆ

### ಶೈಕ್ಷಣಿಕ ತತ್ತ್ವಶಾಸ್ತ್ರ

- ಯೋಜನೆ ಆಧಾರಿತ ವಿದ್ಯಾರ್ಥಿ  
- ನಿಯಮಿತ ಜ್ಞಾನದ ಪರಿಶೀಲನೆಗಳು (ಕ್ವಿಜ್‌ಗಳು)  
- ಕೈಗೆ ಹಾಕುವ ಕೋಡಿಂಗ್ ಅಭ್ಯಾಸಗಳು  
- ನೈಜ ಜಗತ್ತಿನ ಅನ್ವಯಿಕೆ ಉದಾಹರಣೆಗಳು  
- ಫ್ರೇಮ್‌ವರ್ಕ್ ಗಳು ಮುಂದೆ ಮೂಲಭೂತ ತತ್ತ್ವಗಳ ಮೇಲೆ ಹೆಚ್ಚು ಗಮನ

### ರೆಪಾಸಿಟರಿ ನಿರ್ವಹಣೆ

- ಚಟುವಟಿಕೆಯ ಸಮಾಜ ಕಲಿಯುವ, ಕೊಡುಗೆದಾರರೊಂದಿಗೆ  
- ಅವಲಂಬನೆಗಳು ಮತ್ತು ವಿಷಯದ ನಿಯಮಿತ ನವೀಕರಣ  
- ಸಮಸ್ಯೆಗಳು ಮತ್ತು ಚರ್ಚೆಗಳ ಮೇಲ್ವಿಚಾರಣೆಯ ಜೊತೆಗೆ  
- GitHub Actions ಮುಖಾಂತರ ಸ್ವಯಂಚಾಲಿತ ಅನುವಾದ ನವೀಕರಣಗಳು

### ಸಂಬಂಧಿತ ಸಂಪನ್ಮೂಲಗಳು

- [Microsoft Learn modules](https://docs.microsoft.com/learn/)  
- [Student Hub resources](https://docs.microsoft.com/learn/student-hub/)  
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) ಕಲಿಯುವವರಿಗಾಗಿ ಶಿಫಾರಸು ಮಾಡಲಾಗಿದೆ  
- ಹೆಚ್ಚುವರಿ ಕೋರ್ಸುಗಳು: ಜನರೇಟಿವ್ AI, ಡೇಟಾ ವಿಜ್ಞಾನ, ML, IoT ಪಠ್ಯಕ್ರಮಗಳು ಲಭ್ಯ

### ನಿರ್ದಿಷ್ಟ ಯೋಜನೆಗಳೊಂದಿಗೆ ಕೆಲಸ

ವಿವರವಾದ ಸೂಚನೆಗಳಿಗೆ ಪ್ರತಿ ಯೋಜನೆ README ಫೈಲ್‌ಗಳನ್ನು ನೋಡಿ:  
- `quiz-app/README.md` - Vue 3 ಕ್ವಿಜ್ ಅಪ್ಲಿಕೇಶನ್  
- `7-bank-project/README.md` - ದೃಢೀಕರಣದೊಂದಿಗೆ ಬ್ಯಾಂಕಿಂಗ್ ಅಪ್ಲಿಕೇಶನ್  
- `5-browser-extension/README.md` - ಬ್ರೌಸರ್ ವಿಸ್ತರಣೆ ಅಭಿವೃದ್ಧಿ  
- `6-space-game/README.md` - ಕ್ಯಾನ್ವಾಸ್ ಆಧಾರಿತ ಆಟ ಅಭಿವೃದ್ಧಿ  
- `9-chat-project/README.md` - AI ಚಾಟ್ ಸಹಾಯಕ ಯೋಜನೆ

### ಮನುಹಳೆ ರೆಪೊ ರಚನೆ

ಸಾಂಪ್ರದಾಯಿಕ ಮನುಹಳೆ ರೆಪೊ ಅಲ್ಲದಿದ್ದರೂ, ಈ ರೆಪೊ ಬಹು ಸ್ವತಂತ್ರ ಯೋಜನೆಗಳನ್ನು ಹೊಂದಿದೆ:  
- ಪ್ರತಿ ಪಾಠವು ಸ್ವತಂತ್ರವಾಗಿದೆ  
- ಯೋಜನೆಗಳು ಅವಲಂಬನೆಗಳನ್ನು ಹಂಚಿಕೊಳ್ಳುತ್ತಿಲ್ಲ  
- ಪ್ರತಿ ಯೋಜನೆಯಲ್ಲಿ ಪ್ರತ್ಯೇಕವಾಗಿ ಕೆಲಸಮಾಡಿ ಇತರೆಗಳ ಮೇಲೆ ಪ್ರಭಾವ ಬಡಿಸದೆ  
- ಸಂಪೂರ್ಣ ಪಠ್ಯಕ್ರಮದ ಅನುಭವಕ್ಕಾಗಿ ಪೂರ್ಣ ರೆಪೊ ಕ್ಲೋನ್ ಮಾಡಿ

---

<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**ಜವಾಬ್ದಾರಿಯ ಮೌಖ್ಯಕತೆ**:  
ಈ ನನುಮತಿಯನ್ನು AI ಅನುವಾದ ಸೇವೆ [Co-op Translator](https://github.com/Azure/co-op-translator) ಬಳಸಿ ಅನುವಾದಿಸಲಾಗಿದೆ. ನಾವು ಖಚಿತತೆಗಾಗಿ ಪ್ರಯತ್ನಿಸುತ್ತಿದ್ದರೂ, ಸ್ವಯಂಚಾಲಿತ ಅನುವಾದಗಳಲ್ಲಿ ತಪ್ಪುಗಳು ಅಥವಾ ಅಸತ್ಯತೆಗಳು ಇರಬಹುದು ಎಂಬ ವಿಚಾರದಲ್ಲಿ ದಯವಿಟ್ಟು ಗಮನವಿಡಿ. ಮೂಲ ಭಾಷೆಯ ಮೂಲ ದಾಖಲೆ ಆಧिकारिक ಮೂಲವಾಗಿದೆ ಎಂದು ಪರಿಗಣಿಸಬೇಕಿದೆ. ಆವಶ್ಯಕ ಮಾಹಿತಿಗೆ ವೃತ್ತಿಪರ ಮಾನವ ಅನುವಾದವನ್ನು ಶಿಫಾರಸು ಮಾಡಲಾಗುತ್ತದೆ. ಈ ಅನುವಾದವನ್ನು ಬಳಸುವುದರಿಂದ ಉಂಟಾಗುವ ಯಾವುದೇ ಅರ್ಥಮಾಡಿಕೊಳ್ಳದಿಕೆಗಳು ಅಥವಾ ತಪ್ಪುಅರ್ಥೈಸಿಕೆಗಳಿಗೆ ನಾವು ಜವಾಬ್ದಾರರಾಗುವುದಿಲ್ಲ.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->