# AGENTS.md

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

ಇದು ಆರಂಭಿಕರಿಗೆ ವೆಬ್ ಅಭಿವೃದ್ಧಿ ಮೂಲಭೂತಾಂಶಗಳನ್ನು ಕಲಿಸಲು ಉದ್ದೇಶಿಸಿದ ಶಿಕ್ಷಣ ಕಾರ್ಯಕ್ರಮ ಸಂಗ್ರಹಾಲಯವಾಗಿದೆ. ಈ ಕಾರ್ಯಕ್ರಮವು ಮೈಕ್ರೋಸಾಫ್ಟ್ ಕ್ಲೌಡ್ ಅಡ್ವೊಕೆಟ್ಸ್‍ರಿಂದ ಅಭಿವೃದ್ಧಿಪಡಿಸಲ್ಪಟ್ಟ 12 ವಾರಗಳ ಸಂಪೂರ್ಣ ಕೋರ್ಸ್ ಆಗಿದ್ದು, 24 ಕೈಯಿಂದ ಮಾಡಬಹುದಾದ ಪಾಠಗಳನ್ನು ಒಳಗೊಂಡಿವೆ, ಇವು ಜಾವಾಸ್ಕ್ರಿಪ್ಟ್, CSS ಮತ್ತು HTML ಅನ್ನು ಒಳಗೊಂಡಿದೆ.

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

- **ಶೈಕ್ಷಣಿಕ ವಿಷಯಗಳು**: ಪ್ರಾಜೆಕ್ಟ್ ಆಧಾರಿತ ಮೋ듳ುಗಳಾಗಿ ಸಂಘಟಿತ 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 ಅನ್ನು ತೆರೆಯಿರಿ ಅಥವಾ Live Server ಅನ್ನು ಬಳಸಿರಿ
```

### ಚಾಟ್ ಪ್ರಾಜೆಕ್ಟ್ (Python ಬ್ಯಾಕೆಂಡ್)

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

## ಅಭಿವೃದ್ಧಿ ಕಾರ್ಯಪ್ರವಾಹ

### ವಿಷಯದ ಪಾಲುದಾರರಿಗಾಗಿ

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

### ಅಭ್ಯಾಸದ ಇಲ್ಲಿಗೆ

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 ಲೈವ್ ಸರ್ವರ್ ವಿಸ್ತರಣೆ ಬಳಸಿ
- **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 ಶೈಲಿ ಮಾರ್ಗಸೂಚಿಗಳು
- ಸ್ಪಷ್ಟ ಮತ್ತು ಶಿಕ್ಷಣ ಸಂಬಂಧಿ ಕೋಡ್ ಉದಾಹರಣೆಗಳು
- ಕಲಿಕೆಗೆ ಸಹಾಯಕವಾಗುವ ಟೈಪ್ ಸೂಚನೆಗಳು

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

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

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

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

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

### Quiz App ನಿಯೋಜನೆ (Azure Static Web Apps)

quiz-app ಅನ್ನು 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 ರಚಿಸಿ
```

### Docsify ಡಾಕ್ಯುಮೆಂಟೇಶನ್

```bash
npm install -g docsify-cli    # ಡಾಕ್ಸಿಫೈಯನ್ನು ಗ್ಲೋಬಲ್ ಆಗಿ ಸ್ಥಾಪಿಸಿ
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. **ವಿಷಯ ಪರಿಶೀಲನೆ**:
   - ಢೊಾಗಲಿಕೆ ಮತ್ತು ವ್ಯಾಕರಣ ಪರಿಶೀಲಿಸಿ
   - ಕೋಡ್ ಉದಾಹರಣೆಗಳು ಸರಿಯಾಗಿದ್ದು ಮತ್ತು ಶೈಕ್ಷಣಿಕವಾಗಿವೆ ಎಂದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ
   - ಅನುವಾದಗಳು ಮೂಲ ಅರ್ಥವನ್ನು ಕಾಯ್ದಿರುತ್ತವೆ ಎಂದು ಪರಿಶೀಲಿಸಿ

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

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

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

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

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

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

- GitHub Actions ಮತ್ತು co-op-translator ಕಾರ್ಯಪ್ರವಾಹ ಬಳಸಿ
- 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 ಸರಿಯಾಗಿ ರೂಪುಗೊಂಡಿದೆ ಎಂದು ಪರಿಶೀಲಿಸಿ
- ಬ್ರೌಸರ್ ಕೊನ್ಸೋಲ್‍ನಲ್ಲಿ ದೋಷಗಳನ್ನು ನೋಡಿರಿ
- ಬ್ರೌಸರ್-ನಿರ್ದಿಷ್ಟ ವಿಸ್ತರಣೆ ಸ್ಥಾಪನೆ ಸೂಚನೆಗಳನ್ನು ಅನುಸರಿಸಿ

**ಪೈಥಾನ್ ಚಾಟ್ ಪ್ರಾಜೆಕ್ಟ್ ಸಮಸ್ಯೆಗಳು**:
- OpenAI ಪ್ಯಾಕೇಜ್ સ્થાપಿಸಿ: `pip install openai`
- GITHUB_TOKEN ಪರಿಸರ ವ್ಯತ್ಯಯವನ್ನು ಹೊಂದಿರಿ
- GitHub ಮಾದರಿಗಳು ಪ್ರವೇಶವನ್ನು ಪರಿಶೀಲಿಸಿ

**Docsify ಡಾಕ್ಯುಮೆಂಟ್ ಸರ್ವ್ ಆಗುತ್ತಿಲ್ಲ**:
- docsify-cli ಗ್ಲೋಬಲಿಯಾಗಿ ಸ್ಥಾಪಿಸಿ: `npm install -g docsify-cli`
- ಸಂಗ್ರಹಾಲಯ ರೂಟ್ ಡೈರೆಕ್ಟರಿ ಇಂದ ರನ್ ಮಾಡಿ
- `docs/_sidebar.md` ಇದೆ ಎಂದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ

### ಅಭಿವೃದ್ಧಿ ಪರಿಸರ ಮಾರ್ಗಸೂಚಿಗಳು

- HTML ಪ್ರಾಜೆಕ್ಟ್‌ಗಳಿಗೆ VS Code ಲೈವ್ ಸರ್ವರ್ ವಿಸ್ತರಣೆ ಬಳಸಿ
- ನಿರಂತರ ಫಾರ್ಮ್ಯಾಟಿಂಗ್ ಕಾಗದಕ್ಕೆ ESLint ಮತ್ತು Prettier ವಿಸ್ತರಣೆಗಳನ್ನು ಸ್ಥಾಪಿಸಿ
- JavaScript ಡಿಬಗ್ಗಿಂಗ್‌ಗಾಗಿ ಬ್ರೌಸರ್ ಡೆವ್ ನೇಮಕೇಳಗಳನ್ನು ಬಳಸಿ
- Vue ಪ್ರಾಜೆಕ್ಟ್‌ಗಳಿಗೆ Vue DevTools ಬ್ರೌಸರ್ ವಿಸ್ತರಣೆ ಬಳಸಿ

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

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

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

### ಪರಿಸರ ವ್ಯತ್ಯಯಗಳು

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

### ಪೈಥಾನ್ ಪ್ರಾಜೆಕ್ತಿ್ಸಿಗೆ

- ವರ್ಚುಯಲ್ ಪರಿಸರ ಬಳಸಿ: `python -m venv venv`
- ಅವಶ್ಯಕತೆಗಳನ್ನು ನವೀಕರಿಸಿಕೊಂಡಿಟ್ಟು ಹೋಗಿ
- GitHub ಟೋಕನ್‌ಗಳಿಗೆ ಕನಿಷ್ಠ ಅಗತ್ಯ ಪ್ರಾಧಿಕಾರ ಇರುತ್ತದೆ

### GitHub ಮಾದರಿಗಳ ಪ್ರವೇಶ

- GitHub ಮಾದರಿಗಳಿಗೆ ವೈಯಕ್ತಿಕ ಪ್ರವೇಶ ಟೋಕನ್ (PAT) ಅಗತ್ಯ
- ಟೋಕನ್‌ಗಳನ್ನು ಪರಿಸರ ವ್ಯತ್ಯಯಗಳಾಗಿ ಸಂಗ್ರಹಿಸಿ
- ಟೋಕನ್ ಅಥವಾ ಪ್ರಾಮಾಣಪತ್ರಗಳನ್ನು ಎಂದಿಗೂ ಸಲ್ಲಿಸಬೇಡಿ

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

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

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

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

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

### ಸಂಗ್ರಹಾಲಯ ನಿರ್ವಹಣೆ

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

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

- [Microsoft Learn ಮಡುಗಳು](https://docs.microsoft.com/learn/)
- [ವಿದ್ಯಾರ್ಥಿ ಹಬ್ ಸಂಪನ್ಮೂಲಗಳು](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 -->
**ಅಸ್ತವ್ಯವಸ್ಥೆ**:  
ಈ ದಸ್ತಾವೇಜು [Co-op Translator](https://github.com/Azure/co-op-translator) ಎಂಬ AI ಅನುವಾದ ಸೇವೆ ಬಳಸಿ ಅನುವದಿಸಲಾಗಿದೆ. ನಾವು ಶುದ್ಧತೆಯ ಲಕ್ಷ್ಯಕ್ಕಾಗಿ ಪ್ರಯತ್ನಿಸಿದರೂ, ಸ್ವಯಂಚಾಲಿತ ಅನುವಾದಗಳಲ್ಲಿ ದೋಷಗಳು ಅಥವಾ ತಪ್ಪುಗಳಿರುವ ಸಾಧ್ಯತೆ ಇದೆ ಎಂಬುದನ್ನು ದಯವಿಟ್ಟು ಗಮನಿಸಿರಿ. ಮೂಲ ಭಾಷೆಯ ದಸ್ತಾವೇಜು ಸದೃಢ ಮೂಲವಾಗಿ ಪರಿಗಣಿಸಬೇಕು. ಅತ್ಯಂತ ಪ್ರಮುಖ ಮಾಹಿತಿಗಾಗಿ, ವೃತ್ತಿಪರ ಮಾನವ ಅನುವಾದವನ್ನು ಶಿಫಾರಸು ಮಾಡಲಾಗುತ್ತದೆ. ಈ ಅನುವಾದದ ಬಳಕೆಯಿಂದ ಉಂಟಾಗುವ ಯಾವುದೇ ತಪ್ಪು ಗ್ರಹಿಕೆಗಳು ಅಥವಾ ವಿಚಿತ್ರಾರ್ಥಗಳಿಗಾಗಿ ನಾವು ಹೊಣೆಗಾರರಲ್ಲ.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->