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

pull/1690/head
localizeflow[bot] 3 weeks ago
parent dfe67054a3
commit 65541e2034

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-02-06T12:17:20+00:00",
"translation_date": "2026-02-06T13:39:28+00:00",
"source_file": "AGENTS.md",
"language_code": "kn"
},

@ -1,282 +1,282 @@
# AGENTS.md
## Project Overview
## ಪ್ರಾಜೆಕ್ಟ್ ಅವಲೋಕನ
ಇದು ಶುರುಮಾಡುವವರಿಗೆ ವೆಬ್ ಅಭಿವೃದ್ಧಿ ಮೂಲತತ್ವಗಳನ್ನು ಕಲಿಸಲು ಶಿಕ್ಷಣ ಕಾರ್ಯಕ್ರಮ ಶೇಖರಣಾಗಾರವಾಗಿದೆ. ಈ ಪಠ್ಯಕ್ರಮವು ಮೈಕ್ರೋಸಾಫ್ಟ್ ಕ್ಲೌಡ್ ಆ್ಯಡ್ವೊಕೇಟ್‌ಗಳು ಅಭಿವೃದ್ಧಿಪಡಿಸಿರುವ ಸಂಪೂರ್ಣ 12-ವಾರಗಳ ಕೋರ್ಸ್ ಆಗಿದ್ದು, ಜಾವಾಸ್ಕ್ರಿಪ್ಟ್, CSS ಮತ್ತು HTML ಕುರಿತು 24 ಹಸ್ತಚಾಲಿತ ಪಾಠಗಳನ್ನು ಒಳಗೊಂಡಿದೆ.
ಇದು ವೆಬ್ ಡೆವಲಪ್‌ಮೆಂಟ್ ಮೂಲತತ್ವಗಳನ್ನು ಆರಂಭಿಕರಿಗೆ ಕಲಿಸಲು ವಿನ್ಯಾಸಗೊಳಿಸಿರುವ ಶೈಕ್ಷಣಿಕ ಪಠ್ಯಕ್ರಮ ರೆಪೊಸಿಟರಿ. ಈ ಪಠ್ಯಕ್ರಮವು Microsoft Cloud Advocates ಅಭಿವೃದ್ಧಿಪಡಿಸಿದ ಸಂಪೂರ್ಣ 12-ವಾರಗಳ ಕೋರ್ಸ್ ಆಗಿದ್ದು, 24 ಕೈಯಿಂದ ಆ್ಯಕ್ಷನ್ ಪಾಠಗಳನ್ನು ಒಳಗೊಂಡಿದ್ದು, JavaScript, CSS, ಮತ್ತು HTML ಅನ್ನು ಆವರಿಸುತ್ತದೆ.
### Key Components
### ಪ್ರಮುಖ ಅಂಶಗಳು
- **ಿಕ್ಷಣಾತ್ಮಕ ವಿಷಯ**: ಪ್ರಾಜೆಕ್ಟ್ ಆಧರಿತ ಮೋಡ್ಯೂಲ್‌ಗಳಾಗಿ ಸಂಘಟಿತ 24 ರಚಿಸಲ್ಪಟ್ಟ ಪಾಠಗಳು
- **ಪ್ರಾಯೋಗಿಕ ಪ್ರಾಜೆಕ್ಟುಗಳು**: ಟೆರಾರಿಯಂ, ಟೈಪಿಂಗ್ ಗೇಮ್, ಬ್ರೌಸರ್ ಎಕ್ಸ್ಟೆಂಶನ್, ಸ್ಪೇಸ್ ಗೇಮ್, ಬ್ಯಾಂಕಿಂಗ್ ಆಪ್, ಕೋಡ್ ಎಡಿಟರ್, ಮತ್ತು AI ಚಾಟ್ ಸಹಾಯಕ
- **ಇಂಟರಾಕ್ಟಿವ್ ಕ್ವಿಜ್‌ಗಳು**: ಪ್ರತಿ 3 ಪ್ರಶ್ನೆಗಳೊಂದಿಗೆ 48 ಕ್ವಿಜ್‌ಗಳು (ಪೂರ್ವ/ಪೋಸ್ಟ್ ಪಾಠ ಮೌಲ್ಯಮಾಪನ)
- **ಬಹು ಭಾಷಾ ಬೆಂಬಲ**: GitHub Actions ಮುಖಾಂತರ 50+ ಭಾಷೆಗಳಿಗೆ ಸ್ವಯಂಚಾಲಿತ ಅನುವಾದಗಳು
- **ತಂತ್ರಜ್ಞಾನಗಳು**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI ಪ್ರಾಜೆಕ್ಟುಗಳಿಗೆ)
- **ೈಕ್ಷಣಿಕ ವಿಷಯ**: ಪ್ರಾಜೆಕ್ಟ್ ಆಧಾರಿತ ಪ್ರಕ್ರಿಯೆಯಲ್ಲಿ 24 ರಚನಾತ್ಮಕ ಪಾಠಗಳು
- **ಪ್ರಯೋಗಾತ್ಮಕ ಪ್ರಾಜೆಕ್ಟ್‌ಗಳು**: ಟೆರಾರಿಗೆಂ, ಟೈಪಿಂಗ್ ಆಟ, ಬ್ರೌಸರ್ ವಿಸ್ತರಣೆ, ಸ್ಪೇಸ್ ಆಟ, ಬ್ಯಾಂಕಿಂಗ್ ಅಪ್ಲಿಕೇಶನ್, ಕೋಡ್ ಎಡಿಟರ್, ಮತ್ತು AI ಚಾಟ್ ಸಹಾಯಕ
- **ಇಂಟರಾಕ್ಟಿವ್ ಕ್ವಿಜ್‌ಗಳು**: ಪ್ರತಿ 3 ಪ್ರಶ್ನೆಗಳೊಂದಿಗೆ 48 ಕ್ವಿಜ್‌ಗಳು (ಪಾಠದ ಮುಂಚೆ/ಮುಗಿದು ಮೌಲ್ಯಮಾಪನ)
- **ಬಹುಭಾಷಾ ಬೆಂಬಲ**: GitHub Actions ಮೂಲಕ 50+ ಭಾಷೆಗಳ ಸ್ವಯಂಚಾಲಿತ ಅನುವಾದಗಳು
- **ತಂತ್ರಜ್ಞಾನಗಳು**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI ಪ್ರಾಜೆಕ್ಟ್‌ಗಳಿಗೆ)
### Architecture
### ವಾಸ್ತುಶಿಲ್ಪ
- ಪಾಠ ಆಧಾರಿತ ರಚನೆಯಿರುವ ಶಿಕ್ಷಣ ಶೇಖರಣಾಗಾರ
- ಪ್ರತಿ ಪಾಠ ಫೋಲ್ಡರ್‌ನಲ್ಲಿ README, ಕೋಡ್ ಉದಾಹರಣೆಗಳು ಮತ್ತು ಪರಿಹಾರಗಳು ಇರುತ್ತವೆ
- ಪ್ರತ್ಯೇಕ ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ ಸ್ವತಂತ್ರ ಪ್ರಾಜೆಕ್ಟುಗಳು (quiz-app, ವಿವಿಧ ಪಾಠ ಪ್ರಾಜೆಕ್ಟುಗಳು)
- GitHub Actions ಉಪಯೋಗಿಸಿ ಅನುವಾದ ವ್ಯವಸ್ಥೆ (co-op-translator)
- Docsify ಮೂಲಕ ಪ್ರलेಖಸೇವೆ ಮತ್ತು PDF ಆಗಿ ಲಭ್ಯವಿದೆ
- ಪಾಠ ಆಧಾರಿತ ರಚನೆಯೊಂದಿಗೆ ಶೈಕ್ಷಣಿಕ ರೆಪೊಸಿಟರಿ
- ಪ್ರತಿಯೊಬ್ಬ ಪಾಠದ ಫೋಲ್ಡರ್‌ಗೆ README, ಕೋಡ್ ಉದಾಹರಣೆಗಳು ಮತ್ತು ಪರಿಹಾರಗಳು ಇರುತ್ತವೆ
- ಸ್ವತಂತ್ರ ಪ್ರಾಜೆಕ್ಟ್‌ಗಳು ಪ್ರತ್ಯೇಕ ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ (quiz-app, ವಿವಿಧ ಪಾಠ ಪ್ರಾಜೆಕ್ಟ್‌ಗಳು)
- GitHub Actions ಬಳಸಿ ಅನುವಾದ ವ್ಯವಸ್ಥೆ (co-op-translator)
- ಡಾಕ್ಯುಮೆಂಟೇಷನ್ Docsify ಮೂಲಕ ಸೇವ್ ಆಗುತ್ತದೆ ಮತ್ತು PDF ಆಕಾರದಲ್ಲಿಯೂ ಲಭ್ಯವಿದೆ
## Setup Commands
## ಸೆಟ್‌ಅಪ್ ಕಮಾಂಡ್‌ಗಳು
ಈ ರೆಪೊ ಮೂಲತಃ ಶಿಕ್ಷಣ ವಿಷಯ ಉಪಯೋಗಕ್ಕೆ. ನಿರ್ದಿಷ್ಟ ಪ್ರಾಜೆಕ್ಟುಗಳೊಂದಿಗೆ ಕೆಲಸ ಮಾಡಲು:
ಈ ರೆಪೊಸಿಟರಿ ಮುಖ್ಯವಾಗಿ ಶೈಕ್ಷಣಿಕ ವಿಷಯ ಗ್ರಹಿಕೆಗೆ ಇದಾಗಿದೆ. ನಿರ್ದಿಷ್ಟ ಪ್ರಾಜೆಕ್ಟ್‌ಗಳೊಂದಿಗೆ ಕೆಲಸ ಮಾಡಲು:
### Main Repository Setup
### ಮುಖ್ಯ ರೆಪೊಸಿಟರಿ ಸೆಟ್‌ಅಪ್
```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners
```
### Quiz App Setup (Vue 3 + Vite)
### ಕ್ವಿಜ್ ಅಪ್ ಸೆಟ್‌ಅಪ್ (Vue 3 + Vite)
```bash
cd quiz-app
npm install
npm run dev # ಡೆವಲಪ್‌ಮೆಂಟ್ ಸರ್ವರ್ ಪ್ರಾರಂಭಿಸಿ
npm run dev # ಅಭಿವೃದ್ಧಿ ಸರ್ವರ್ ಪ್ರಾರಂಭಿಸಿ
npm run build # ಉತ್ಪಾದನೆಗಾಗಿ ನಿರ್ಮಿಸಿ
npm run lint # ESLint ಅನ್ನು ಚಾಲನೆ ಮಾಡಿ
npm run lint # ESLint ನಿರ್ವಹಿಸಿ
```
### Bank Project API (Node.js + Express)
### ಬ್ಯಾಂಕ್ ಪ್ರಾಜೆಕ್ಟ್ API (Node.js + Express)
```bash
cd 7-bank-project/api
npm install
npm start # API ಸರ್ವರ್ ಪ್ರಾರಂಭಿಸಿ
npm run lint # ESLint ಅನ್ನು ಚಾಲನೆ ಮಾಡು
npm run format # Prettier ಬಳಸಿ ಸ್ವರೂಪಗೊಳಿಸಿ
npm run lint # ESLint ಅನ್ನು ರನ್ ಮಾಡಿ
npm run format # Prettier ಬಳಸಿ ವಿನ್ಯಾಸಗೊಳಿಸಿ
```
### Browser Extension Projects
### ಬ್ರೌಸರ್ ವಿಸ್ತರಣೆ ಪ್ರಾಜೆಕ್ಟ್‌ಗಳು
```bash
cd 5-browser-extension/solution
npm install
# ಬ್ರೌಸರ್-ನಿರ್ದಿಷ್ಟ ವಿಸ್ತರಣೆ ಲೋಡಿಂಗ್ ಸೂಚನೆಗಳನ್ನು ಅನುಸರಿಸಿ
# ಬ್ರೌಸರ್-ನಿರ್ದಿಷ್ಟ ವಿಸ್ತರಣಾ ಲೋಡಿಂಗ್ ನಿರ್ದೇಶನಗಳನ್ನು ಅನುಸರಿಸಿ
```
### Space Game Projects
### ಸ್ಪೇಸ್ ಆಟ ಪ್ರಾಜೆಕ್ಟ್‌ಗಳು
```bash
cd 6-space-game/solution
npm install
# ಬ್ರೌಸರ್‌ನಲ್ಲಿ index.html ತೆರೆ ಅಥವಾ ಲೈವ್ ಸರ್ವರ್ ಬಳಸಿ
# index.html ಅನ್ನು ಬ್ರೌಸರ್‌ನಲ್ಲಿ ತೆರಯಿರಿ ಅಥವಾ ಲೈವ್ ಸರ್ವರ್ ಅನ್ನು ಬಳಸಿರಿ
```
### Chat Project (Python Backend)
### ಚಾಟ್ ಪ್ರಾಜೆಕ್ಟ್ (Python ಬ್ಯಾಕೆಂಡ್)
```bash
cd 9-chat-project/solution/backend/python
pip install openai
# GITHUB_TOKEN ಪರಿಸರ ಚರವನ್ನು ಸೆಟ್ ಮಾಡಿ
# GITHUB_TOKEN ಪರಿಸರ ಚರವನ್ನು அமைಸು
python api.py
```
## Development Workflow
## ಅಭಿವೃದ್ಧಿ ಕಾರ್ಯಪ್ರವಾಹ
### For Content Contributors
### ವಿಷಯ ದಾನಿಗಳನ್ನು 위한
1. **ನಿಮ್ಮ GitHub ಖಾತೆಗೆ ರೆಪೊ ಫೋರ್ಕ್ ಮಾಡಿ**
2. **ನಿಮ್ಮ ಫೋರ್ಕ್ ಅನ್ನು ಲೊಕಲಿ ಕ್ಲೋನ್ ಮಾಡಿ**
3. **ನಿಮ್ಮ ಬদಲಾಗುಗಳಿಗೆ ಹೊಸ ಶಾಖೆ ರಚಿಸಿ**
4. ಪಾಠ ವಿಷಯ ಅಥವಾ ಕೋಡ್ ಉದಾಹರಣೆಗಳಲ್ಲಿ ಬದಲಾವಣೆ ಮಾಡಿ
5. ಸಂಬಂಧಿತ ಪ್ರಾಜೆಕ್ಟ್ ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ ಯಾವುದೇ ಕೋಡ್ ಬದಲಾವಣೆಗಳನ್ನು ಪರೀಕ್ಷಿಸಿ
6. ಕೊಡುಗೆ ಮಾರ್ಗಸೂಚಿಗಳ ಆಧಾರದ ಮೇಲೆ ಪುಲ್ ರಿಕ್ವೆಸ್ಟ್ ಸಲ್ಲಿಸಿ
1. **ರೆಪೊಸಿಟರಿ ಫೋರ್ಕ್ ಮಾಡಿ** ನಿಮ್ಮ GitHub ಖಾತೆಗೆ
2. **ನಿಮ್ಮ ಫೋರ್ಕನ್ನು ಕ್ಲೋನ್ ಮಾಡಿ** ಲೋಕಲ್‌ಗೆ
3. **ಹೊಸ ಬ್ರಾಂಚ್ ರಚಿಸಿ** ನಿಮ್ಮ ಬದಲಾವಣೆಗಳಿಗೆ
4. ಪಾಠ ವಿಷಯ ಅಥವಾ ಕೋಡ್ ಉದಾಹರಣೆಗಳನ್ನು ಬದಲಾಯಿಸಿ
5. ಸಂಬಂಧಿತ ಪ್ರಾಜೆಕ್ಟ್ ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ ಯಾವುದೇ ಕೋಡ್ ಬದಲಾವಣೆಗಳನ್ನು ಪರೀಕ್ಷಿಸಿ
6. ದಾನ ನಿಯಮಾವಳಿಗಳನ್ನು ಅನುಸರಿಸಿ ಪುಲ್ ರಿಕ್ವೆಸ್ಟ್ ಸಲ್ಲಿಸಿ
### For Learners
### ಕಲಿಯುವವರಿಗಾಗಿ
1. ರೆಪೊ ಫೋರ್ಕ್ ಅಥವಾ ಕ್ಲೋನ್ ಮಾಡಿ
2. ಕ್ರಮಬದ್ಧವಾಗಿ ಪಾಠ ಡೈರೆಕ್ಟರಿಗಳನ್ನು ಅನ್ವೇಷಿಸಿ
3. ಪ್ರತಿಯೊಂದು ಪಾಠಕ್ಕೆ README ಫೈಲ್ ಓದಿ
4. https://ff-quizzes.netlify.app/web/ ನಲ್ಲಿ ಪೂರ್ವ ಪಾಠ ಕ್ವಿಜ್‌ಗಳನ್ನು ಪೂರ್ಣಗೊಳಿಸಿ
5. ಪಾಠ ಫೋಲ್ಡರ್‌ಗಳಲ್ಲಿ ಕೋಡ್ ಉದಾಹರಣೆಗಳ ಮೂಲಕ ಕೆಲಸ ಮಾಡಿ
6. ಕಾರ್ಯಗಳನ್ನು ಮತ್ತು ಸವಾಲುಗಳನ್ನು ಪೂರ್ಣಗೊಳಿಸಿ
7. ಪೋಸ್ಟ್-ಪಾಠ ಕ್ವಿಜ್‌ಗಳನ್ನು ತೆಗೆದುಕೊಳ್ಳಿ
1. ರೆಪೊಸಿಟರಿ ಅನ್ನು ಫೋರ್ಕ್ ಅಥವಾ ಕ್ಲೋನ್ ಮಾಡಿ
2. ಕ್ರಮವಾಗಿ ಪಾಠ ಡೈರೆಕ್ಟರಿಗಳಿಗೆ ಹೋಗಿ
3. ಪ್ರತಿಯೊಬ್ಬ ಪಾಠದ README ಫೈಲ್ಗಳನ್ನು ಓದಿ
4. https://ff-quizzes.netlify.app/web/ ನಲ್ಲಿ ಪೂರ್ವ-ಪಾಠ ಕ್ವಿಜ್‌ಗಳನ್ನು ಪೂರ್ಣಗೊಳಿಸಿ
5. ಪಾಠ ಫೋಲ್ಡರ್‌ಗಳಲ್ಲಿ ಕೋಡ್ ಉದಾಹರಣೆಗಳ ಮೂಲಕ ಕೆಲಸ ಮಾಡಿ
6. ಕಾರ್ಯಗಳನ್ನು ಮತ್ತು ಸವಾಲುಗಳನ್ನು ಪೂರ್ಣಗೊಳಿಸಿ
7. ನಂತರದ ಪಾಠ ಕ್ವಿಜ್‌ಗಳನ್ನು ಪೂರೈಸಿ
### Live Development
### ಲೈವ್ ಅಭಿವೃದ್ಧಿ
- **ಡಾಕ್ಯುಮೆಂಟೇಶನ್**: ಚುರುಕಾಗಿ `docsify serve` ರುಟ್‌ನಲ್ಲಿ (ಪೋರ್ಟ್ 3000)
- **ಕ್ವಿಜ್ ಆಪ್**: quiz-app ಡೈರೆಕ್ಟರಿಯಲ್ಲಿ `npm run dev` ಚಾಲನೆ ಮಾಡಿ
- **ಪ್ರಾಜೆಕ್ಟ್ಗಳು**: HTML ಪ್ರಾಜೆಕ್ಟ್ಗಾಗಿ VS Code ಲೈವ್ ಸರ್ವರ್ ವಿಸ್ತರಣೆ ಬಳಸಿ
- **API ಪ್ರಾಜೆಕ್ಟ್‌ಗಳು**: ತಕ್ಕ API ಡೈರೆಕ್ಟರಿಗಳು `npm start` ಚಾಲನೆ ಮಾಡಿ
- **ಡಾಕ್ಯುಮೆಂಟೇಷನ್**: ರೂಟ್‌ನಲ್ಲಿ `docsify serve` ಅನ್ನು ರನ್ ಮಾಡಿ (ಪೋರ್ಟ್ 3000)
- **ಕ್ವಿಜ್ ಅಪ್**: `quiz-app` ಡೈರೆಕ್ಟರಿಯಲ್ಲಿ `npm run dev` ಅನ್ನು ರನ್ ಮಾಡಿ
- **ಪ್ರಾಜೆಕ್ಟ್‌ಗಳು**: HTML ಪ್ರಾಜೆಕ್ಟ್‌ಗಳಿಗೆ VS Code ಲೈವ್ ಸರ್ವರ್ ವಿಸ್ತರಣೆಯನ್ನು ಬಳಸಿ
- **API ಪ್ರಾಜೆಕ್ಟ್‌ಗಳು**: ಸಂಬಂಧಿತ API ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ `npm start` ರನ್ ಮಾಡಿ
## Testing Instructions
## ಪರೀಕ್ಷೆ ಸೂಚನೆಗಳು
### Quiz App Testing
### ಕ್ವಿಜ್ ಅಪ್ ಪರೀಕ್ಷೆ
```bash
cd quiz-app
npm run lint # ಕೋಡ್ ಶೈಲಿ ಸಮಸ್ಯೆಗಳಿಗಾಗಿ ಪರಿಶೀಲಿಸಿ
npm run build # ನಿರ್ಮಾಣ ಯಶಸ್ವಿಯಾಗಿದ್ದೇ ಎಂದು ಪರಿಶೀಲಿಸಿ
npm run lint # ಕೋಡ್ ಶೈಲಿ ಸಮಸ್ಯೆಗಳನ್ನು ಪರಿಶೀಲಿಸಿ
npm run build # ನಿರ್ಮಾಣ ಯಶಸ್ವಿಯಾಗಿದೆಯೇ ಎಂದು ಪರಿಶೀಲಿಸಿ
```
### Bank API Testing
### ಬ್ಯಾಂಕ್ API ಪರೀಕ್ಷೆ
```bash
cd 7-bank-project/api
npm run lint # ಕೋಡ್ ಶೈಲಿ ಸಮಸ್ಯೆಗಾಗಿ ಪರಿಶೀಲಿಸಿ
node server.js # ದೋಷವಿಲ್ಲದೆ ಸರ್ವರ್ ಪ್ರಾರಂಭವಾಗುತ್ತದೆಯೋ ಆಗ್ನೈಯಿಸಿ
npm run lint # ಕೋಡ್ ಶೈಲಿ ಸಮಸ್ಯೆಗಳಿಗಾಗಿ ಪರಿಶೀಲಿಸಿ
node server.js # ಸರ್ವರ್ ದೋಷವಿಲ್ಲದೆ ಪ್ರಾರಂಭವಾಗುತ್ತದೆ ಎಂದು ದೃಢೀಕರಿಸಿ
```
### General Testing Approach
### ಸಾಮಾನ್ಯ ಪರೀಕ್ಷೆ ವಿಧಾನ
- ಇದು ಸಂಪ್ರಾಪ್ತಿಯಾಗದ ಸ್ವಯಂಚಾಲಿತ ಪರೀಕ್ಷೆಗಳಿಲ್ಲದ ಶಿಕ್ಷಣ ರೆಪೊ
- ಕೈಗಾರಿಕಾ ಪರೀಕ್ಷೆಗಳಿಗೆ ಹೀಗೆ ಗಮನ:
- ಕೋಡ್ ಉದಾಹರಣೆಗಳು ದೋಷ ರಹಿತವಾಗಿ ಕಾರ್ಯನಿರ್ವಹಿಸಬೇಕು
- ಡಾಕ್ಯುಮೆಂಟ್‍ಲ್ಲಿ ಲಿಂಕ್‌ಗಳು ಸರಿಯಾಗಿರಬೇಕು
- ಪ್ರಾಜೆಕ್ಟ್ ನಿರ್ಮಾಣ ಸುಲಭವಾಗಿರಬೇಕು
- ಉದಾಹರಣೆಗಳು ಉತ್ತಮ ಅಭ್ಯಾಸಗಳನ್ನು ಅನುಸರಿಸಬೇಕು
- ಇದು ಸಂಪೂರ್ಣ ಸ್ವಯಂಚಾಲಿತ ಪರೀಕ್ಷೆಗಳು ಇಲ್ಲದ ಶೈಕ್ಷಣಿಕ ರೆಪೊಸಿಟರಿ
- ಕೈಯಿಂದ ಮಾಡಲಾದ ಪರೀಕ್ಷೆಗಳಲ್ಲಿ ಗಮನ:
- ಕೋಡ್ ಉದಾಹರಣೆಗಳು ದೋಷರಹಿತವಾಗಿ ರನ್ ಆಗುತ್ತವೆ
- ಡಾಕ್ಯುಮೆಂಟೇಷನ್‌ನ ಲಿಂಕ್‌ಗಳು ಸರಿಯಾಗಿ ಕೆಲಸ ಮಾಡುತ್ತವೆ
- ಪ್ರಾಜೆಕ್ಟ್ ಬಿಲ್ಡು ಯಶಸ್ವಿಯಾಗಿ ಪೂರ್ಣಗೊಳ್ಳುತ್ತವೆ
- ಉದಾಹರಣೆಗಳು ಅತ್ಯುತ್ತಮ ವಿಧಾನಗಳನ್ನು ಅನುಸರಿಸುತ್ತವೆ
### Pre-submission Checks
### ಪೂರ್ವ ಸಬ್ಮಿಷನ್ ಪರಿಶೀಲನೆಗಳು
- package.json ಇರುವ ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ `npm run lint` ಚಾಲನೆ ಮಾಡಿ
- ಮಾರ್ಕ್‌ಡೌನ್ ಲಿಂಕ್‌ಗಳನ್ನು ಸರಿಹೊಂದಿಸಿ
- ಬ್ರೌಸರ್ ಅಥವಾ Node.js ನಲ್ಲಿ ಕೋಡ್ ಉದಾಹರಣೆಗಳನ್ನು ಪರೀಕ್ಷಿಸಿ
- ಅನುವಾದಗಳು ಸರಿಯಾದ ರಚನೆಯನ್ನು ಕಾಪಾಡಬಹುದು ಎಂದು ಪರಿಶೀಲಿಸಿ
- package.json ಇರುವ ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ `npm run lint` ರನ್ ಮಾಡಿ
- ಮಾರ್ಕ್ಡೌನ್ ಲಿಂಕ್‌ಗಳ ಮಾನ್ಯತೆ ಪರಿಶೀಲಿಸಿ
- ಬ್ರೌಸರ್ ಅಥವಾ Node.js ನಲ್ಲಿ ಕೋಡ್ ಉದಾಹರಣೆಗಳನ್ನು ಪರೀಕ್ಷಿಸಿ
- ಅನುವಾದಗಳು ಸರಿಯಾದ ರಚನೆಯನ್ನು ಕಾಪಾಡುತ್ತವೆ ಎಂದು ಖಚಿತಪಡಿಸಿ
## Code Style Guidelines
## ಕೋಡ್ ಶೈಲಿ ಮಾರ್ಗಸೂಚಿಗಳು
### JavaScript
### ಜಾವಾಸ್ಕ್ರಿಪ್ಟ್
- ಆಧುನಿಕ ES6+ ಸಂರಚನೆ ಬಳಸಿರಿ
- ಪ್ರಾಜೆಕ್ಟ್‌ಗಳಲ್ಲಿ ಒದಗಿಸಲಾಗಿರುವ ಸ್ಟ್ಯಾಂಡರ್ಡ್ ESLint ಕಾನ್ಫಿಗರೆಶನ್ ಅನುಸರಿಸಿ
- ಶಿಕ್ಷಣಕ್ಕಾಗಿ ಅರ್ಥಪೂರ್ಣ ಸ್ಥಿರಾಂಕ ಮತ್ತು ಕಾರ್ಯನಾಮಗಳನ್ನು ಬಳಸಿರಿ
- ಕಲಿಯುತ್ತಿದ್ದವರಿಗೆ ಸಂಪ್ರದಾಯಗಳನ್ನು ವಿವರಿಸುವ ಕಾಮೆಂಟ್‌ಗಳನ್ನು ಸೇರಿಸಿ
- Prettier ಸಿದ್ಧವಿದ್ದಲ್ಲಿ ಆನ್ವಯಿಸಿ
- ಆಧುನಿಕ ES6+ ಸಿಂಟ್ಯಾಕ್ಸ್ ಬಳಸಿ
- ಪ್ರಾಜೆಕ್ಟ್‌ಗಳಲ್ಲಿ ನೀಡಲಾದ ಮಾನ್ಯ ESLint ಸಂರಚನೆಯನ್ನು ಅನುಸರಿಸಿ
- ಶೈಕ್ಷಣಿಕ ಸ್ಪಷ್ಟತೆಗಾಗಿ ಅರ್ಥಪೂರ್ಣ ವ್ಯತ್ಯಾಸ ಮತ್ತು ಕಾರ್ಯಗಳ ಹೆಸರುಗಳನ್ನು ಬಳಸಿ
- ಕಲಿಯುವವರಿಗೆ ಅರ್ಥ ಮಾಡಿಸಿಕೊಡುವ ಕಾಮೆಂಟ್‌ಗಳನ್ನು ಸೇರಿಸಿ
- Prettier ಬಳಕೆ ಮಾಡಿ ಫಾರ್ಮ್ಯಾಟ್ ಮಾಡಿ (ಅಂತರ್ಗತವಾಗಿದ್ದಲ್ಲಿ)
### HTML/CSS
- ಅರ್ಥಪೂರ್ಣ HTML5 ಅಂಶಗಳು
- ಪ್ರತಿಕ್ರಿಯಾಶೀಲ ವಿನ್ಯಾಸ ತತ್ವಗಳು
- ಸ್ಪಷ್ಟ ಕ್ಲಾಸ್ ಹೆಸರು ವ್ಯವಸ್ಥೆ
- CSS ತಂತ್ರಜ್ಞಾನಗಳಿಗಾಗಿ ಕಲಿಯುವವರಿಗೆ ಕಾಮೆಂಟ್‌ಗಳು
- ಅರ್ಥಪೂರ್ಣ HTML5 ಅನುಘಟನಗಳು
- ಪ್ರತಿಕ್ರಿಯಾತ್ಮಕ ವಿನ್ಯಾಸ ತತ್ವಗಳು
- ಸ್ಪಷ್ಟ ಕ್ಲಾಸ್ ನಾಮಕರಣ ನಿಯಮಗಳು
- ಕಲಿಯುವವರಿಗೆ CSS ತಂತ್ರಜ್ಞಾನಗಳನ್ನು ವಿವರಿಸುವ ಕಾಮೆಂಟ್‌ಗಳು
### Python
### ಪೈಥಾನ್
- PEP 8 ಶೈಲಿ ಮಾರ್ಗಸೂಚಿ
- ಸ್ಪಷ್ಟ, ಶಿಕ್ಷಣಾತ್ಮಕ ಕೋಡ್ ಉದಾಹರಣೆಗಳು
- ಕಲಿಕೆಯಿಗಾಗಿ ಸಹಾಯವಾದ ಟೈಪ್ ಸೂಚನೆಗಳು
- PEP 8 ಶೈಲಿ ಮಾರ್ಗಸೂಚಿಗಳು
- ಸ್ಪಷ್ಟ, ಶೈಕ್ಷಣಿಕ ಕೋಡ್ ಉದಾಹರಣೆಗಳು
- ಸಹಾಯವಾಗುವಿ್ದರೆ ಟೈಪ್ ಸೂಚನೆಗಳು
### Markdown Documentation
### ಮಾರ್ಕ್ಡೌನ್ ಡಾಕ್ಯುಮೆಂಟೇಷನ್
- ಸ್ಪಷ್ಟ ಶೀರ್ಷಿಕಾ ಹಿರarkoನಾಮಿ
- ಭಾಷಾ ನಿರ್ದಿಷ್ಟತೆಳ್ಳದ ಕೋಡ್ ಬ್ಲಾಕ್‌ಗಳು
- ಹೆಚ್ಚಿ ಸಂಪನ್ಮೂಲಗಳ ಲಿಂಕ್‌ಗಳು
- `images/` ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ ಸ್ಕ್ರೀನ್‌ಶಾಟ್ ಮತ್ತು ಚಿತ್ರಗಳು
- ಪ್ರಾಪ್ಯದತೆಗಾಗಿ ಚಿತ್ರಗಳಿಗೆ Alt ಪಠ್ಯ
- ಸ್ಪಷ್ಟ ಶೀರ್ಷಿಕೆ ಹೈರಾರ್ಕಿ
- ಭಾಷಾ ಸ್ಪಷ್ಟೀಕರಣದೊಂದಿಗೆ ಕೋಡ್ ಬ್ಲಾಕ್ಸ್
- ಹೆಚ್ಚುವರಿ ಸಂಪನ್ಮೂಲಗಳಿಗೆ ಲಿಂಕ್‌ಗಳು
- screenshots ಮತ್ತು ಚಿತ್ರಗಳು `images/` ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ
- ಅಕ್ಸೆಸಿಬಿಲಿಟಿಗಾಗಿ ಚಿತ್ರಗಳಿಗೆ Alt ಟೆಕ್ಸ್ಟ್
### File Organization
### ಫೈಲ್ ಸಂಘಟನೆ
- ಪಾಠಗಳು ಕ್ರಮಬದ್ಧ ಸಂಖ್ಯೆಗಳಿಸುವ (1-getting-started-lessons, 2-js-basics, ಇತ್ಯಾದಿ)
- ಪ್ರತಿ ಪ್ರಾಜೆಕ್ಟ್‌ಗೆ `solution/` ಮತ್ತು ಸಾಮಾನ್ಯವಾಗಿ `start/` ಅಥವಾ `your-work/` ಡೈರೆಕ್ಟರಿಗಳು ಇವೆ
- ಚಿತ್ರಗಳು ಪಾಠ-ವಿಶಿಷ್ಟ `images/` ಫೋಲ್ಡರ್‌ಗಳಲ್ಲಿ ಇರುತ್ತವೆ
- ಅನುವಾದಗಳು `translations/{language-code}/` ರಚನೆಯಲ್ಲಿ ಇರುತ್ತವೆ
- ಪಾಠಗಳು ಕ್ರಮಬದ್ಧ ಸಂಖ್ಯೆಗಳಲ್ಲಿ (1-getting-started-lessons, 2-js-basics, ಇತ್ಯಾದಿ)
- ಪ್ರತಿ ಪ್ರಾಜೆಕ್ಟ್‌ಗೆ ಸಾಮಾನ್ಯವಾಗಿ `solution/` ಮತ್ತು `start/` ಅಥವಾ `your-work/` ಡೈರೆಕ್ಟরি ಇರುತ್ತದೆ
- ಚಿತ್ರಗಳು ಪಠ್ಯಕ್ರಮ-ವೈಯಕ್ತಿಕ `images/` ಫೋಲ್ಡರ್‌ಗಳಲ್ಲಿ ಸಂಗ್ರಹಿಸಿವೆ
- ಅನುವಾದಗಳು `translations/{language-code}/` ರಚನೆಯಲ್ಲಿ
## Build and Deployment
## ನಿರ್ಮಾಣ ಮತ್ತು ನಿಯೋಜನೆ
### Quiz App Deployment (Azure Static Web Apps)
### ಕ್ವಿಜ್ ಅಪ್ ನಿಯೋಜನೆ (Azure Static Web Apps)
quiz-app ಅನ್ನು Azure Static Web Apps ನಿಯೋಜನೆಗಾಗಿ ಸಂರಚಿಸಲಾಗಿದೆ:
ಕ್ವಿಜ್-ಆಪ್ Azure Static Web Apps ನಿಯೋಜನೆಗೆ ಹೊಂದಿಕೊಳ್ಳುವಂತೆ ಕಾನ್ಫಿಗರ್ ಮಾಡಲಾಗಿದೆ:
```bash
cd quiz-app
npm run build # dist/ ಫೋಲ್ಡರ್ ಅನ್ನು ರಚಿಸುತ್ತದೆ
# main ಗೆ ಪುಶ್ ಮಾಡುವಾಗ GitHub Actions ವರ್ಕ್‌ಫ್ಲೋ ಮೂಲಕ ನಿಯೋಜಿಸುತ್ತದೆ
# ಮುಖ್ಯ ಶಾಖೆಗೆ ಪುಷ್ ಮಾಡಿದಾಗ GitHub Actions ವರ್ಕ್‌ಫ್ಲೋ ಮೂಲಕ ನಿಯೋಜಿಸಲಾಗುತ್ತದೆ
```
Azure Static Web Apps ಸಂರಚನೆ:
- **ಆಪ್ ಸ್ಥಾನ**: `/quiz-app`
- **ಫಲಿತಾಂಶ ಸ್ಥಳ**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Documentation PDF Generation
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 # docs ನಿಂದ PDF ರಚಿಸಿ
npm run convert # ಡಾಕ್ಸ್‌ನಿಂದ PDF ರಚಿಸಿ
```
### Docsify Documentation
### Docsify ಡಾಕ್ಯುಮೆಂಟೇಷನ್
```bash
npm install -g docsify-cli # ಡಾಕ್ಸಿಫೈನ್ನು ಗ್ಲೋಬೆಲಿಯಾಗಿ ಸಂಪರ್ಕಿಸಿ
docsify serve # localhost:3000 ನಲ್ಲಿ ಸೇವೆ ನೀಡಿ
npm install -g docsify-cli # ಡಾಕ್ಸಿಫಿ ಅನ್ನು ಜಾಗತಿಕವಾಗಿ ಸ್ಥಾಪಿಸಿ
docsify serve # localhost:3000 ನಲ್ಲಿ ಸೇವೆ ಸಲ್ಲಿಸಿ
```
### Project-specific Builds
ಪ್ರತಿ ಪ್ರಾಜೆಕ್ಟ್ ಡೈರೆಕ್ಟರಿಯ নিজস্ব ಬಿಲ್ಡ್ ಪ್ರಕ್ರಿಯೆ ಇರಬಹುದು:
- Vue ಪ್ರಾಜೆಕ್ಟ್‌ಗಳು: `npm run build` ಮೂಲಕ ಉತ್ಪಾದನಾ ಬುಂಡಲ್‌ಗಳು ಸೃಷ್ಟಿ
- ಸ್ಥಿರ ಪ್ರಾಜೆಕ್ಟ್‌ಗಳು: ಬಿಲ್ಡ್ ಸ್ತರವಿಲ್ಲ, ನೇರವಾಗಿ ಕಡತ ಸೇವೆ 제공
### ಪ್ರಾಜೆಕ್ಟ್-ನಿರ್ದಿಷ್ಟ ಬಿಲ್ಡ್‌ಗಳು
ಪ್ರತಿ ಪ್ರಾಜೆಕ್ಟ್ ಡೈರೆಕ್ಟರಿಯಲ್ಲಿ ತನ್ನದೇ ಆದ ಬಿಲ್ಡ್ ಪ್ರಕ್ರಿಯೆ ಇರಬಹುದು:
- Vue ಪ್ರಾಜೆಕ್ಟ್‌ಗಳು: `npm run build` ಮೂಲಕ ಉತ್ಪಾದನಾ ಬಂಡಲ್‌ಗಳನ್ನು ರಚಿಸುತ್ತದೆ
- ಸ್ಥಿತಿ ಪ್ರಾಜೆಕ್ಟ್‌ಗಳು: ಯಾವುದೇ ಬಿಲ್ಡ್ ಹಂತವಿಲ್ಲ, ನೇರವಾಗಿ ಫೈಲ್ಗಳನ್ನು ಸರ್ವ್ ಮಾಡುತ್ತದೆ
## Pull Request Guidelines
## ಪುಲ್ ರಿಕ್ವೆಸ್ಟ್ ಮಾರ್ಗಸೂಚಿಗಳು
### Title Format
### ಶೀರ್ಷಿಕೆ ಸ್ವರೂಪ
ಬದಲಾವಣೆ ಪ್ರದೇಶವನ್ನು ಸೂಚಿಸುವ ಸ್ಪಷ್ಟ, ವಿವರಣೆಗೂಡಿದ ಶೀರ್ಷಿಕೆ ಬಳಸಿ:
- `[Quiz-app] ಪಾಠ X ಗಾಗಿ ಹೊಸ ಕ್ವಿಜ್ ಸೇರಿಸಲಾಗಿದೆ`
- `[Lesson-3] ಟೆರಾರಿಯಂ ಪ್ರಾಜೆಕ್ಟ್‌ನಲ್ಲಿ ಟೈಪೋ ಸರಿಪಡಿಸಲಾಗಿದೆ`
- `[Translation] ಪಾಠ 5 ಸ್ಪ್ಯಾನಿಷ್ ಅನುವಾದ ಸೇರಿಸಲಾಗಿದೆ`
- `[Docs] ಸೆಟಪ್ ಸೂಚನೆಗಳ ನವೀಕರಣ`
ಬದಲಾವಣೆ ಕ್ಷೇತ್ರವನ್ನು ಸ್ಪಷ್ಟವಾಗಿ ಸೂಚಿಸುವ ಶೀರ್ಷಿಕೆಗಳನ್ನು ಬಳಸಿ:
- `[Quiz-app] ಪಾಠ X ಗೆ ಹೊಸ ಕ್ವಿಜ್ ಸೇರಿಸಿ`
- `[Lesson-3] Terrarium ಪ್ರಾಜೆಕ್ಟ್‌ನ ತಪ್ಪು ತಿದ್ದಿ`
- `[Translation] ಪಾಠ 5 ಕ್ಕೆ ಸ್ಪ್ಯಾನಿಷ್ ಅನುವಾದ ಸೇರಿಸಿ`
- `[Docs] ಸೆಟ್‌ಅಪ್ ಸೂಚನೆಗಳನ್ನು ತಿದ್ದುಪಡಿ ಮಾಡಿ`
### Required Checks
### ಅಗತ್ಯ ಪರಿಶೀಲನೆಗಳು
PR ಸಲ್ಲಿಸುವ ಮುನ್ನ:
PR ಸಲ್ಲಿಸುವ ಮೊದಲು:
1. **ಕೋಡ್ ಗುಣಮಟ್ಟ**:
- ಬದಲಾಯಿಸಿದ ಪ್ರಾಜೆಕ್ಟು ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ `npm run lint` ಚಾಲನೆ ಮಾಡಿ
- ಎಲ್ಲಾ ಲಿಂಟ್ ದೋಷಗಳು ಮತ್ತು ಎಚ್ಚರಿಕೆಗಳನ್ನು ಸರಿಪಡಿಸಿ
1. **ಕೋಡ್ ಗುಣಮಟ್ಟ**:
- ಸಂಬಂಧಿತ ಪ್ರಾಜೆಕ್ಟ್ ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ `npm run lint` ರನ್ ಮಾಡಿ
- ಎಲ್ಲಾ ಲಿಂಟಿಂಗ್ ದೋಷಗಳು ಮತ್ತು ಎಚ್ಚರಿಕೆಗಳನ್ನು ಸರಿಪಡಿಸಿ
2. **ಬಿಲ್ ಪರಿಶೀಲನೆ**:
- ಅನ್ವಯಿಸುವಲ್ಲಿ `npm run build` ಚಾಲನೆ ಮಾಡಿ
- ಯಾವುದೇ ಬಿಲ್ ದೋಷ ಇಲ್ಲದಂತೆ ಖಚಿತ ಮಾಡಿ
2. **ಬಿಲ್ಡ್ ಪರಿಶೀಲನೆ**:
- ಅನ್ವಯಿಸುವಲ್ಲಿ `npm run build` ರನ್ ಮಾಡಿ
- ಯಾವುದೇ ಬಿಲ್ಡ್ ದೋಷಗಳಿಲ್ಲದಿರುವುದನ್ನು ಖಚಿತಪಡಿಸಿ
3. **ಲಿಂಕ್ ಪರಿಶೀಲನೆ**:
- ಎಲ್ಲಾ ಮಾರ್ಕ್ಡೌನ್ ಲಿಂಕ್‌ಗಳನ್ನು ಪರೀಕ್ಷಿಸಿ
- ಚಿತ್ರ ಉಲ್ಲೇಖಗಳು ಸರಿಯಾಗಿವೆ ಎಂದು ದೃಢೀಕರಿಸಿ
3. **ಲಿಂಕ್ ಮಾನ್ಯತೆ**:
- ಎಲ್ಲಾ ಮಾರ್ಕ್ಡೌನ್ ಲಿಂಕ್‌ಗಳನ್ನು ಪರೀಕ್ಷಿಸಿ
- ಚಿತ್ತರ ಸಂದರ್ಭಗಳು ಕಾರ್ಯನಿರ್ವಹಿಸುತ್ತವೆ ಎಂದು ಖಚಿತಪಡಿಸಿ
4. **ವಿಷಯ ಪರಿಶೀಲನೆ**:
- ಶಬ್ದಲೇಖನ ಹಾಗೂ ವ್ಯಾಕರಣ ಪರೀಕ್ಷೆ
- ಕೋಡ್ ಉದಾಹರಣೆಗಳು ಸರಿಯಾದ ಮತ್ತು ಶಿಕ್ಷಣಾದ್ದಂತಿರಲಿ
- ಅನುವಾದಗಳು ಮೂಲ ಅರ್ಥವನ್ನು ಕಾಪಾಡುತ್ತವೆ ಎಂದು ದೃಢೀಕರಿಸಿ
4. **ವಿಷಯ ವಿಮರ್ಶೆ**:
- ವ್ಯಾಕರಣ ಮತ್ತು ಸ್ಪೆಲಿಂಗ್ ಪರಿಶೀಲನೆ ಮಾಡಿ
- ಕೋಡ್ ಉದಾಹರಣೆಗಳು ಸರಿಯಾದ ಮತ್ತು ಶೈಕ್ಷಣಿಕವಾಗಿರುವುದನ್ನು ಖಚಿತಪಡಿಸಿ
- ಅನುವಾದಗಳು ಮೂಲ ಅರ್ಥವನ್ನು ಕಾಪಾಡುತ್ತವೆ ಎಂದು ದೃಢಪಡಿಸಿ
### Contribution Requirements
### ದಾನಗೈಯುವ ಅಗತ್ಯತೆಗಳು
- Microsoft CLA ಗೆ ಒಪ್ಪಿಗೆ ವ್ಯಕ್ತಪಡಿಸಿ (ಮೊದಲ PR ನಲ್ಲಿ ಸ್ವಯಂಚಾಲಿತ ಪರಿಶೀಲನೆ)
- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) ಅನುಸರಿಸಿ
- ವಿವರವಾದ ಮಾರ್ಗಸೂಚಿಗಾಗಿ [CONTRIBUTING.md](./CONTRIBUTING.md) ನೋಡಿ
- ಪ್ರಕರಣ ಸಂಖ್ಯೆಗಳನ್ನು PR ವಿವರಣೆಯಲ್ಲಿ ಉಲ್ಲೇಖಿಸಿ, ಅಗತ್ಯವಿದ್ದರೆ
- Microsoft CLA ಅನ್ನು ಒಪ್ಪಿಕೊಳ್ಳಿ (ಮೊದಲ PR ನಲ್ಲಿ ಸ್ವಯಂಚಾಲಿತ ಪರಿಶೀಲನೆ)
- [Microsoft ಓಪನ್ ಸೋರ್ಸ್ ಕೊಂಡಿ](https://opensource.microsoft.com/codeofconduct/) ಅನುಸರಿಸಿ
- ವಿವರಿತ ಮಾರ್ಗಸೂಚಿಗಳಿಗಾಗಿ [CONTRIBUTING.md](./CONTRIBUTING.md) ನೋಡಿ
- PR ವಿವರಣೆಯಲ್ಲಿ ಅನುಕೂಲ ವಿಧಾನಗಳ/issues ಸಂಖ್ಯೆಗಳ ಉಲ್ಲೇಖ ಮಾಡಿ
### Review Process
### ವಿಮರ್ಶೆ ಪ್ರಕ್ರಿಯೆ
- PR ಗಳನ್ನು ನಿರ್ವಹಕರ ಮತ್ತು ಸಮುದಾಯ ವಿಮರ್ಶಿಸುವರು
- ಶಿಕ್ಷಣ ಸ್ಪಷ್ಟತೆಕೆ ಆದ್ಯತೆ
- ಕೋಡ್ ಉದಾಹರಣೆಗಳು ಇತ್ತೀಚಿನ ಉತ್ತಮ ಅಭ್ಯಾಸಗಳನ್ನು ಅನುಸರಿಸಬೇಕು
- ಅನುವಾದಗಳನ್ನು ನಿಖರತೆ ಮತ್ತು ಸಾಂಸ್ಕೃತಿಕ ಸೂಕ್ತತೆಗಾಗಿ ಪರಿಶೀಲನೆ
- PR ಗಳು ನಿರಂತರಕ ಹಾಗೂ ಸಮುದಾಯದವರ ಪರಿಶೀಲನೆಯಲ್ಲಿ ಇರುತ್ತವೆ
- ಶೈಕ್ಷಣಿಕ ಸ್ಪಷ್ಟತೆಯೇ ಪ್ರಾಥಮಿಕತೆ
- ಕೋಡ್ ಉದಾಹರಣೆಗಳು ಇತ್ತೀಚಿನ ಅತ್ಯುತ್ತಮ ವಿಧಾನಗಳನ್ನು ಅನುಸರಿಸಬೇಕು
- ಅನುವಾದಗಳನ್ನು ನಿಖರತೆ ಮತ್ತು ಸಾಂಸ್ಕೃತಿಕ ಸೂಕ್ತತೆಯುಳ್ಳವೆಯೆಂಬುದಾಗಿ ಪರಿಶೀಲಿಸಲಾಗುತ್ತದೆ
## Translation System
## ಅನುವಾದ ವ್ಯವಸ್ಥೆ
### Automated Translation
### ಸ್ವಯಂಚಾಲಿತ ಅನುವಾದ
- GitHub Actions ಉಪಯೋಗಿಸಿ co-op-translator ವಾರ್ಕ್‌ಫ್ಲೋ
- 50+ ಭಾಷೆಗಳಿಗೆ ಸ್ವಯಂಚಾಲಿತ ಅನುವಾದಗಳು
- ಮೂಲ ಕಡತಗಳು ಮುಖ್ಯ ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿವೆ
- ಅನುವಾದಿತ ಕಡತಗಳು `translations/{language-code}/` ರಚನೆಯಲ್ಲಿ ಇರುತ್ತವೆ
- GitHub Actions ಮತ್ತು co-op-translator ಕಾರ್ಯಪ್ರವಾಹ ಬಳಕೆ
- 50+ ಭಾಷೆಗಳಿಗಾಗಿ ಸ್ವಯಂಚಾಲಿತವಾಗಿ ಅನುವಾದನ
- ಮೂಲ ಫೈಲ್‌ಗಳು ಮುಖ್ಯ ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ ಇರುತ್ತವೆ
- ಅನುವಾದಿತ ಫೈಲ್‌ಗಳು `translations/{language-code}/` ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ ಇರುತ್ತವೆ
### Adding Manual Translation Improvements
### ಕೈಯಿಂದ ಅನುವಾದ ಸುಧಾರಣೆಗಳನ್ನು ಸೇರಿಸುವುದು
1. `translations/{language-code}/` ನಲ್ಲಿ ಕಡತವನ್ನು ಹುಡುಕಿ
2. ರಚನೆ ಕಾಪಾಡಿಕೊಂಡು ಸುಧಾರಣೆ ಮಾಡಿ
3. ಕೋಡ್ ಉದಾಹರಣೆಗಳು ಕಾರ್ಯಾಚರಣೆಯಲ್ಲಿರಬೇಕು ಎಂದು ಖಚಿತ ಆಗಿರಿ
4. ಆನುವಾದಿತ ಕ್ವಿಜ್ ವಿಷಯ ಅಂತರ್ಜಾಲದಲ್ಲೂ ಜವಾಬ್ದಾರಿ ಪರೀಕ್ಷೆ ಮಾಡಿ
1. `translations/{language-code}/` ಒಳಗಿನ ಫೈಲ್ ಅನ್ನು ಹುಡುಕಿ
2. ರಚನೆಯನ್ನು ಕಾಪಾಡಿಕೊಂಡು ಸುಧಾರಣೆ ಮಾಡಿ
3. ಕೋಡ್ ಉದಾಹರಣೆಗಳು ಕಾರ್ಯನಿರ್ವಹಣೆಯಲ್ಲಿವೆ ಎಂದು ಖಚಿತಪಡಿಸಿ
4. ಸ್ಥಳೀಯ ಕ್ವಿಜ್ ವಿಷಯವನ್ನು ಪರೀಕ್ಷಿಸಿ
### Translation Metadata
### ಅನುವಾದ ಮೆಟಾಡೇಟಾ
ಅನುವಾದಿತ ಕಡತಗಳು ಮೆಟಾಡೇಟಾ ಹೆಡರ್ ಅನ್ನು ಒಳಗೊಂಡಿವೆ:
ಅನುವಾದಿತ ಫೈಲ್‌ಗಳು ಮೆಟಾಡೇಟಾ ಹೆಡರ್ ಒಳಗೊಂಡಿರುತ್ತದೆ:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -288,121 +288,121 @@ CO_OP_TRANSLATOR_METADATA:
}
-->
```
## Debugging and Troubleshooting
### Common Issues
## ಡಿಬಗ್ ಮತ್ತು ಸಮಸ್ಯೆ ಪರಿಹಾರ
### ಸಾಮಾನ್ಯ ಸಮಸ್ಯೆಗಳು
**ಕ್ವಿಜ್ ಆಪ್ ಪ್ರಾರಂಭವಾಗುತ್ತಿಲ್ಲ**:
- Node.js ಆವೃತ್ತಿ (v14+ ಶಿಫಾರಸು) ಪರಿಶೀಲಿಸಿ
- `node_modules` ಮತ್ತು `package-lock.json`ಳಿಸಿ, ಮತ್ತೆ `npm install` ಮಾಡಿ
- ಪೋರ್ಟ್ ಸಂಕಷ್ಟಗಳಿಗಾಗಿ ಪರಿಶೀಲಿಸಿ (ಮೂಲ: Vite 5173 ಪೋರ್ಟ್ ಉಪಯೋಗಿಸು)
**ಕ್ವಿಜ್ ಅಪ್ ಪ್ರಾರಂಭವಾಗುವುದಿಲ್ಲ**:
- Node.js ಆವೃತ್ತಿ چೇಕ್ ಮಾಡಿ (v14+ ಶಿಫಾರಸ್ಸಾಗಿದೆ)
- `node_modules` ಮತ್ತು `package-lock.json`ನ್ನು ಅಳಿಸಿ, ನಂತರ `npm install` ರನ್ ಮಾಡಿ
- ಪೋರ್ಟ್ ಕಾನ್ಫ್ಲಿಕ್ಟ್ಗಳಿಗಾಗಿ ಪರಿಶೀಲಿಸಿ (ಡೀಫಾಲ್ಟ್: Vite 5173 ಪೋರ್ಟ್ ಬಳಸುತ್ತದೆ)
**API ಸರ್ವರ್ ಪ್ರಾರಂಭವಾಗುತ್ತಿಲ್ಲ**:
- ಕನಿಷ್ಠ Node.js ಆವೃತ್ತಿ ಒಪ್ಪಿಗೆಯಾದ್ದು (node >=10)
- ಪೋರ್ಟ್ ಈಗಾಗಲೇ ಬಳಸಲಾಜ್ಞೆ ಇದೆಯೇ ಪರಿಶೀಲನೆ
- ಎಲ್ಲಾ ಅವಲಂಬನೆಗಳು `npm install` ಮೂಲಕ ಸ್ಥಾಪನೆಯಾಗಿವೆ ನೋಡಿ
**API ಸರ್ವರ್ ಪ್ರಾರಂಭವಾಗುವುದಿಲ್ಲ**:
- Node.js ಆವೃತ್ತಿ ಕನಿಷ್ಠ ಬ್ಯಾಂಕಿಂಗ್ ಮಾಡಿದೆ ಎಂದು ಪರಿಶೀಲಿಸಿ (node >=10)
- ಪೋರ್ಟ್ ಬಳಕೆಯಲ್ಲಿ ಇದೆ ಎಂದು ಪರಿಶೀಲಿಸಿ
- ಎಲ್ಲಾ ಅವಲಂಬನೆಗಳು `npm install` ಮೂಲಕ ಸ್ಥಾಪಿಸಲಾಗಿದೆ ಎಂದು ಖಚಿತಪಡಿಸಿ
**ಬ್ರೌಸರ್ ಎಕ್ಸ್ಟೆಂಶನ್ ಲೋಡ್ ಆಗುತ್ತಿಲ್ಲ**:
- manifest.json ಸರಿಯಾಗಿ ಸ್ವರೂಪಗೊಳಿಸಲಾಗಿದೆ ಎಂದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ
- ಬ್ರೌಸರ್ ಕನ್‌ಸೋಲ್ ದೋಷ ಉಂಟೆಂದೂ ನೋಡಿ
- ಬ್ರೌಸರ್-ನಿರ್ದಿಷ್ಟ ಎಕ್ಸ್ಟೆಂಶನ್ ಸ್ಥಾಪನೆ ನಿಯಮಗಳನ್ನು ಅನುಸರಿಸಿ
**ಬ್ರೌಸರ್ ಎಕ್ಸ್ಟೆನ್ಷನ್ ಲೋಡ್ ಆಗುವುದಿಲ್ಲ**:
- manifest.json ಸರಿಯಾದ ಫಾರ್ಮ್ಯಾಟ್ ನಲ್ಲಿ ಇದೆ ಅಂತ ಪರಿಶೀಲಿಸಿ
- ಬ್ರೌಸರ್ ಕನ್ಸೋಲ್‌ನಲ್ಲಿ ದೋಷಗಳಿವೆ ಎಂದು ಪರಿಶೀಲಿಸಿ
- ಬ್ರೌಸರ್ ಪ್ರತ್ಯೇಕ ಎಕ್ಸ್ಟೆನ್ಷನ್ ಸ್ಥಾಪನೆ ಸೂಚನೆಗಳನ್ನು ಅನುಸರಿಸಿ
**ಪೈಥಾನ್ ಚಾಟ್ ಪ್ರಾಜೆಕ್ಟ್ ಸಮಸ್ಯೆಗಳು**:
- OpenAI ಪ್ಯಾಕೇಜ್ ಸ್ಥಾಪಿಸಿ: `pip install openai`
- GITHUB_TOKEN ಪರಿಸರ ಚರ ತೆರವು ಮುಂಜೂರು ದೊರಕಿಸಿದೆಯೇ ನೋಡಿ
- GitHub ಮಾದರಿ ಪ್ರವೇಶ ಹಕ್ಕುಗಳ ಪರಿಶೀಲನೆ ಮಾಡಿ
**ಪೈಥಾನ್ ಚಾಟ್ ಪ್ರಾಜೆಕ್ಟ್ ಸಮಸ್ಯೆಗಳು**:
- OpenAI ಪ್ಯಾಕೇಜ್ ಇಂಸ್ಟಾಲ್ ಮಾಡಲಾಗಿದೆ ಎಂದು ಖಚಿತಪಡಿಸಿ: `pip install openai`
- GITHUB_TOKEN ಪರಿಸರ ವ್ಯತ್ಯಯವನ್ನು ಸೆಟ್ ಮಾಡಲಾಗಿದೆ ಎಂದು ಪರಿಶೀಲಿಸಿ
- GitHub ಮಾದರಿಗಳ ಪ್ರವೇಶ ಅನುಮತಿಗಳನ್ನು ಪರಿಶೀಲಿಸಿ
**ಡಾಕ್ಸಿಫೈ ಡಾಕ್ಯುಮೆಂಟ್ ಸರ್ವ್ವಾಗುತ್ತಿಲ್ಲ**:
- docsify-cli ಜಾಗತಿಕವಾಗಿ ಸ್ಥಾಪಿಸಿ: `npm install -g docsify-cli`
- ರೆಪೊ ರೂಟ್ ಡೈರೆಕ್ಟರಿಯಿಂದ ಚಾಲನೆ ಮಾಡಿ
- `docs/_sidebar.md` ಲಭ್ಯವಿದೆಯೇ ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ
**Docsify ಡಾಕ್ಯುಮೆಂಟ್ ಸರ್ವ್ ಆಗದೇ ಇದ್ದರೆ**:
- docsify-cli ಗ್ಲೋಬಲ್ ಆಗಿ ಇನ್‌ಸ್ಟಾಲ್ ಮಾಡಿ: `npm install -g docsify-cli`
- ರೆಪೊಸಿಟರಿ ರೂಟ್ ಡೈರೆಕ್ಟರಿ ರಿಂದ ರನ್ ಮಾಡಿ
- `docs/_sidebar.md` ಇದ್ದು ಎಂದು ಪರಿಶೀಲಿಸಿ
### Development Environment Tips
### ಅಭಿವೃದ್ಧಿ ಪರಿಸರ ಸಲಹೆಗಳು
- HTML ಪ್ರಾಜೆಕ್ಟ್ಗಾಗಿ VS Code ಲೈವ್ ಸರ್ವರ್ ವಿಸ್ತರಣೆ ಬಳಸಿ
- ಸಮಾನ ಸ್ವರೂಪಕ್ಕಾಗಿ ESLint ಮತ್ತು Prettier ವಿಸ್ತರಣೆಗಳನ್ನು ಸ್ಥಾಪಿಸಿ
- JavaScript ದೋಷ ಪರೀಕ್ಷೆಗೆ ಬ್ರೌಸರ್ ಡೆವ್ ಟೂಲ್ಸ್ ಉಪಯೋಗಿಸಿ
- Vue ಪ್ರಾಜೆಕ್ಟ್ಗಾಗಿ Vue DevTools ಬ್ರೌಸರ್ ವಿಸ್ತರಣೆ ಇನ್ಸ್ಟಾಲ್ ಮಾಡಿ
- HTML ಪ್ರಾಜೆಕ್ಟ್‌ಗಳಿಗೆ VS Code ಲೈವ್ ಸರ್ವರ್ ವಿಸ್ತರಣೆ ಬಳಸಿ
- સતત ಸ್ವರೂಪಕ್ಕಾಗಿ ESLint ಮತ್ತು Prettier ವಿಸ್ತರಣೆಗಳನ್ನು ಇನ್‌ಸ್ಟಾಲ್ ಮಾಡಿಕೊಳ್ಳಿ
- ಜಾವಾಸ್ಕ್ರಿಪ್ಟ್ ಡಿಬಗ್‌ಗೆ ಬ್ರೌಸರ್ ಡಿವ್‌ಟೂಲ್‌ಗಳನ್ನು ಬಳಸಿ
- Vue ಪ್ರಾಜೆಕ್ಟ್‌ಗಳಿಗೆ Vue DevTools ಬ್ರೌಸರ್ ವಿಸ್ತರಣೆ ಇನ್ಸ್ಟಾಲ್ ಮಾಡಿ
### Performance Considerations
### ಕಾರ್ಯಕ್ಷಮತೆ ಪರಿಗಣನೆಗಳು
- ಅನುವಾದಿಸಿದ ಕಡತಗಳು (50+ ಭಾಷೆಗಳು) ಅಪಾರವಾಗಿರುವುದರಿಂದ ಪೂರ್ಣ ಕ್ಲೋನ್ಗಳು ಭಾರೀ
- ವಿಷಯದみに ಕೆಲಸಮಾಡಿರೋಂದಿಗೆ ಶಲ್ಲೋ ಕ್ಲೋನ್ ಬಳಸಿ: `git clone --depth 1`
- ಇಂಗ್ಲಿಷ್ ವಿಷಯದ ಮೇಲೆ ಕೆಲಸ ಮಾಡುವಾಗ ಅನುವಾದಗಳನ್ನು ಹುಡುಕಾಟದಿಂದ ಹೊರತುಪಡಿಸಿ
- ಮೊದಲ ಚಲನೆಯಲ್ಲಿರುವ ಬಿಲ್ಡ್ ಪ್ರಕ್ರಿಯೆಗಳು ನಿಧಾನವಾಗಬಹುದು (npm install, Vite build)
- ಅನುವಾದಿತ ಫೈಲ್‌ಗಳ ಬಹುಮಾನ (50+ ಭಾಷೆಗಳು) ಸಂಪೂರ್ಣ ಕ್ಲೋನ್ ದೊಡ್ಡದಾಗುತ್ತದೆ
- ಕೇವಲ ವಿಷಯದಲ್ಲಿ ಕೆಲಸ ಮಾಡುತ್ತಿದ್ದರೆ ಶಾಲೋ ಕ್ಲೋನ್ ಬಳಸಿ: `git clone --depth 1`
- ಇಂಗ್ಲಷ್ ವಿಷಯದ ಮೇಲೆ ಕೆಲಸ ಮಾಡುವಾಗ ಅನುವಾದಗಳನ್ನು ಹುಡುಕಾಟದಲ್ಲಿ ಹೊರತುಪಡಿಸಿ
- ಹಲವು ಬಿಲ್ಡ್ ಪ್ರಕ್ರಿಯೆಗಳು ಮೊದಲ ರನ್‌ನಲ್ಲಿ ನಿಧಾನವಾಗಬಹುದು (npm install, Vite build)
## Security Considerations
## ಭದ್ರತೆ ಪರಿಗಣನೆಗಳು
### Environment Variables
### ಪರಿಸರ ವ್ಯತ್ಯಯಗಳು
- API ಕಿಗಳು ಎಂದಿಗೂ ರೆಪೊಗೆ ಕಮಿಟ್ ಮಾಡಬೇಡಿ
- `.env` ಫೈಲ್ ಬಳಸಿರಿ (ಇದು `.gitignore` ನಲ್ಲಿ ಸೇರಿಸಲಾಗಿದೆ)
- ಪ್ರಾಜೆಕ್ಟ್ README ಗಳಲ್ಲಿ ಅಗತ್ಯವಿರುವ ಪರಿಸರ ಚರ ವಿವರಿಸಿ
- API ಕೀಗಳನ್ನು ರೆಪೊಸಿಟರಿಗೆ ಎಂದಿಗೂ ಕಮಿಟ್ ಮಾಡಬೇಡಿ
- `.env` ಫೈಲ್‌ಗಳನ್ನು ಬಳಸಿ (ಇವು `.gitignore` ನಲ್ಲಿ ಸೇರಿವೆ)
- ಪ್ರಾಜೆಕ್ಟ್ READMEಗಳಲ್ಲಿ ತೋಪು ಬೇಕಾಗುವ ಪರಿಸರ ವ್ಯತ್ಯಯಗಳನ್ನು ದಾಖಲು ಮಾಡಿ
### Python Projects
### ಪೈಥಾನ್ ಪ್ರಾಜೆಕ್ಟ್‌ಗಳು
- ವರ್ಚುವಲ್ ಎನ್ವಿರಾನ್‌ಮೆಂಟ್ ಬಳಸಿರಿ: `python -m venv venv`
- ಅವಲಂಬನೆಗಳನ್ನು ನವೀಕರಿಸಿ
- GitHub ಟೋಕನ್‌ಗಳಿಗೆ ಕನಿಷ್ಟ ಅಗತ್ಯ ಹಕ್ಕುಗಳನ್ನು ನೀಡಿರಿ
- ವರ್ಚುವಲ್ ಎನ್ವೈರನ್ಮೆಂಟ್‌ಗಳನ್ನು ಬಳಸಿ: `python -m venv venv`
- ಅವಲಂಬನೆಗಳನ್ನು ಮುಂದುವರಿಸಿ ಅಪ್ಡೇಟ್ ಮಾಡಿ
- GitHub ಟೋಕನ್‌ಗಳು ಕನಿಷ್ಠ ಅಗತ್ಯ ಅನುಮತಿಗಳಬೇಕು
### GitHub Models Access
### GitHub ಮಾದರಿಗಳ ಪ್ರವೇಶ
- GitHub ಮಾದರಿಗಳಿಗೆ ಪರ್ಸನಲ್ ಆಕ್ಸೆಸ್ ಟೋಕನ್‌ಗಳು (PAT) ಅಗತ್ಯವಿದೆ
- ಟೋಕನ್‌ಗಳನ್ನು ಪರಿಸರ ಚರಗಳಲ್ಲಿ ಸಂಗ್ರಹಿಸಿ
- ಟೋಕನ್ ಅಥವಾ ಕ್ರೆಡೆಂಶಿಯಲ್ಗಳು ಎಂದಿಗೂ ಕಮಿಟ್ ಮಾಡಬೇಡಿ
- GitHub ಮಾದರಿಗಳಿಗೆ ವೈಯಕ್ತಿಕ ಪ್ರವೇಶ ಟೋಕನ್‌ಗಳು (PAT) ಅಗತ್ಯವಾಗಿವೆ
- ಟೋಕನ್‌ಗಳನ್ನು ಪರಿಸರ ವ್ಯತ್ಯಯಗಳಾಗಿ ಸಂಗ್ರಹಿಸಿ
- ಟೋಕನ್‌ಗಳು ಅಥವಾ ಕ್ರೆಡೆನ್ಷಿಯಲ್ಸ್‌ ಅನ್ನು ಎಂದಿಗೂ ಕಮಿಟ್ ಮಾಡಬೇಡಿ
## Additional Notes
## ಹೆಚ್ಚುವರಿ ಟಿಪ್ಪಣಿಗಳು
### Target Audience
### ಗುರಿ ಪ್ರೇಕ್ಷಣೀಯ ವರ್ಗ
- ಸಂಪೂರ್ಣ ಆರಂಭಸಿದ, ವೆಬ್ ಅಭಿವೃದ್ಧಿಗೆ ಹೊಸವರು
- ವಿದ್ಯಾರ್ಥಿಗಳು ಮತ್ತು ಸ್ವಯಂ ಕಲಿಯುವವರು
- ತರಗತಿಯಲ್ಲಿ ಪಠ್ಯಕ್ರಮ ಬಳಸಿ ಶಿಕ್ಷಕರು
- ವಿಷಯವು ಪ್ರಾಪ್ಯತೆ ಮತ್ತು ಹಂತಬದ್ಧ ಕೌಶಲ್ಯ ನಿರ್ಮಾಣಕ್ಕೆ ವಿನ್ಯಾಸಗೊಳಿಸಲಾಗಿದೆ
- ಸಂಪೂರ್ಣ ಆರಂಭಿಕರು ವೆಬ್ ಡೆವಲಪ್‌ಮೆಂಟ್‌ನಲ್ಲಿ
- ವಿದ್ಯಾರ್ಥಿಗಳು ಮತ್ತು ಸ್ವಯಂ-ಕಲಿಯುವವರು
- ತರಗತಿ ಬಳಕೆಗೆ ಶಿಕ್ಷಕರ ಶೈಕ್ಷಣಿಕ ಪಠ್ಯಕ್ರಮ
- ವಿಷಯವನ್ನು ಎಲ್ಲರಿಗೂ ಸುಲಭವಾಗಿ ಮತ್ತು ಕ್ರಮೇಣ ಕೌಶಲ್ಯ ಅಭಿವೃದ್ಧಿಗೆ ವಿನ್ಯಾಸಗೊಳಿಸಲಾಗಿದೆ
### Educational Philosophy
### ಶೈಕ್ಷಣಿಕ ತತ್ತ್ವಶಾಸ್ತ್ರ
- ಪ್ರಾಜೆಕ್ಟ್ ಆಧಾರಿತ ಕಲಿಕೆ ವಿಧಾನ
- ನಿಯಮಿತ ಜ್ಞಾನ ಪರಿಶೀಲನೆಗಳು (ಕ್ವಿಜ್‌ಗಳು)
- ಹಸ್ತಚಾಲಿತ ಕೋಡಿಂಗ್ ವ್ಯಾಯಾಮಗಳು
- ವಾಸ್ತವಿಕ ಜಗತ್ತಿನ ಅನ್ವಯಿಸುವಿಕೆ ಉದಾಹರಣೆಗಳು
- ಫ್ರೇಮ್ವರ್ಕ್‌ಗಳ ಹಿಂದೆ ಮೂಲತತ್ವಪ್ರಜ್ಞೆ ಮೇಲೆ ಗಮನ
- ಪ್ರಾಜೆಕ್ಟ್ ಆಧಾರಿತ ಕಲಿಕೆ ವಿಧಾನ
- ನಿಯಮಿತ ಜ್ಞಾನ ಪರೀಕ್ಷೆಗಳು (ಕ್ವಿಜ್‌ಗಳು)
- ಕೈಯಿಂದ ಕೋಡಿಂಗ್ ಅಭ್ಯಾಸಗಳು
- ವಾಸ್ತವಿಕ ಜಗತ್ತಿನ ಉದಾಹರಣೆಗಳು
- ಫ್ರೆಮ್ವರ್ಕ್‌ಗಳಿಗಿಂತ ಮೊದಲು ಮೂಲತತ್ವಗಳ ಮೇಲೆ ಗಮನ
### Repository Maintenance
### ರೆಪೊಸಿಟರಿ ನಿರ್ವಹಣೆ
- ಕಲಿಕೆಯಲ್ಲಿ ನಿರತ ಸದಸ್ಯರ ಸಮುದಾಯ
- ಅವಲಂಬನೆ ಮತ್ತು ವಿಷಯಗಳ ನಿಯಮಿತ ನವೀಕರಣ
- ನಿರ್ವಹಕರು ಭದ್ರಪಡೆದುಕೊಂಡ ಪ್ರಶ್ನೆಗಳು ಮತ್ತು ಚರ್ಚೆಗಳು
- GitHub Actions ಮುಖಾಂತರ ಸ್ವಯಂಚಾಲಿತ ಅನುವಾದ ನವೀಕರಣಗಳು
- ಶಾಸಕರ ಮತ್ತು ದಾನಿಗಳ ಸಕ್ರಿಯ ಸಮುದಾಯ
- ಅವಲಂಬನೆಗಳು ಮತ್ತು ವಿಷಯದ ನಿಯಮಿತ ಅಪ್ಡೇಟ್ಗಳು
- ನಿರ್ವಹಕರನಿಂದ ಸಮಸ್ಯೆಗಳು ಮತ್ತು ಚರ್ಚೆಗಳು ಮോണಿಟರ್ ಮಾಡಲಾಗುತ್ತದೆ
- ಅನುವಾದಗಳ ತಾಜಾ ಅಪ್ಡೇಟ್‌ಗಳು GitHub Actions ಮೂಲಕ ಸ್ವಯಂಚಾಲಿತ
### Related Resources
### ಸಂಬಂಧಿತ ಸಂಪನ್ಮೂಲಗಳು
- [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, ಡೇಟಾ ಸೈನ್ಸ್, ಎಂಎಲ್, ಐಒಟಿ ಪಠ್ಯಕ್ರಮಗಳು ಲಭ್ಯ
- [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 ಪಠ್ಯಕ್ರಮಗಳು ಲಭ್ಯವಿವೆ
### Working with Specific Projects
### ನಿರ್ದಿಷ್ಟ ಪ್ರಾಜೆಕ್ಟ್‌ಗಳೊಂದಿಗೆ ಕಾರ್ಯನಿರ್ವಹಣೆ
ವಿಶೇಷ ಪ್ರಾಜೆಕ್ಟ್ಗಳ ವಿವರಣೆಗೆ, ಸಹಾಯಕ್ಕಾಗಿ 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 ಚಾಟ್ ಸಹಾಯಕ ಪ್ರಾಜೆಕ್ಟ್
ವಿವರವಾದ ನಿರ್ದೇಶನಗಳಿಗಾಗಿ ಪ್ರತಿ ಪ್ರಾಜೆಕ್ಟ್ 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 ಚಾಟ್ ಸಹಾಯಕ ಪ್ರಾಜೆಕ್ಟ್
### Monorepo Structure
### ಮಾನೋರೆಪೊ ರಚನೆ
ಸಾಧಾರಣ ಮאָנೋರೆಪೋ ಅಲ್ಲ, ಆದರೆ ಈ ರೆಪೊನಲ್ಲಿ ಹಲವು ಸ್ವತಂತ್ರ ಪ್ರಾಜೆಕ್ಟುಗಳಿವೆ:
- ಪ್ರತಿ ಪಾಠ ಸ್ವತಂತ್ರವಿದೆ
- ಪ್ರಾಜೆಕ್ಟುಗಳು ಅವಲಂಬನೆಗಳನ್ನು ಹಂಚ戒ಕೊಳ್ಳುತ್ತಿಲ್ಲ
- ಒಬ್ಬ ಪ್ರಾಜೆಕ್ಟಿನ ಮೇಲೆ ಕೆಲಸ ಮಾಡಬೇಕು ಮತ್ತು ಇತರರ ಮೇಲೆ ಪರಿಣಾಮ ಇರಬಾರದು
- ಪೂರ್ಣ ಪಠ್ಯಕ್ರಮ ಅನುಭವಕ್ಕಾಗಿ ಸಂಪೂರ್ಣ ರೆಪೊ ಕ್ಲೋನ್ ಮಾಡಿ
ಪಾರಂಪರಿಕ ಮಾನೋರೆಪೊ ಅಲ್ಲದರೂ ಈ ರೆಪೊದಲ್ಲಿ ಹಲವಾರು ಸ್ವತಂತ್ರ ಪ್ರಾಜೆಕ್ಟ್‌ಗಳಿವೆ:
- ಪ್ರತಿಯೊಂದು ಪಾಠ ಸ್ವತಂತ್ರವಾಗಿದೆ
- ಪ್ರಾಜೆಕ್ಟ್‌ಗಳು ಅವಲಂಬನೆಗಳನ್ನು ಹಂಚಿಕೊಳ್ಳುವುದಿಲ್ಲ
- ಇತರ ಪ್ರಾಜೆಕ್ಟ್‌ಗಳಿಗೆ ಪರಿಣಾಮ ಬೀರದೆ ಪ್ರತ್ಯೇಕವಾಗಿ ಕೆಲಸ ಮಾಡಿ
- ಸಂಪೂರ್ಣ ಪಠಕ್ರಮ ಅನುಭವಕ್ಕಾಗಿ ಸಂಪೂರ್ಣ ರೆಪೊ ಕ್ಲೋನ್ ಮಾಡಿ
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**ವಿಮೋಚನೆ**:
ಈ ದಸ್ತಾವೇಜನ್ನ AI অনುವಾದ ಸೌಲಭ್ಯ [Co-op Translator](https://github.com/Azure/co-op-translator) ಬಳಸಿ ಅನುವದಿಸಲಾಗಿದೆ. ನಾವು ಶುದ್ಧತೆಗೆ ಪ್ರಯತ್ನ ಮಾಡುವುದಾದರೂ, ಸ್ವಯಂಚಾಲಿತ ಅನುವಾದಗಳಲ್ಲಿ ತಪ್ಪುಗಳು ಅಥವಾ ಅಸತ್ಯತೆಗಳಿರಬಹುದು ಎಂದು ದಯವಿಟ್ಟು ಗಮನಿಸಿ. ಮೂಲ ಭಾಷೆಯ ಮೂಲ ದಸ್ತಾವೇಜನ್ನು ಅಧಿಕೃತ ಮೂಲವೆಂದು ಪರಿಗಣಿಸಬೇಕು. ಮಹತ್ವದ ಮಾಹಿತಿಗಾಗಿ, ವೃತ್ತಿಪರ ಮಾನವ ಅನುವಾದವನ್ನು ಶಿಫಾರಸು ಮಾಡಲಾಗುತ್ತದೆ. ಈ ಅನುವಾದ ಬಳಕೆಯಿಂದಾಗಿ ಹುಟ್ಟಿದ ಯಾವುದೇ ಅರ್ಥಬೇಧ ಅಥವಾ ತಪ್ಪಾದ ಅರ್ಥೈಸಿಕೆಗೆ ನಾವು ಜವಾಬ್ದಾರಿಯಲ್ಲದಿದ್ದೇವೆ.
**ಚೈತ್ಯ ನಿರಾಕರಣೆ**:
ಈ ದಸ್ತಾವೇಜು [Co-op Translator](https://github.com/Azure/co-op-translator) ಎಂಬ AI ಅನುವಾದ ಸೇವೆಯನ್ನು ಬಳಸಿ ಅನುವಾದಿಸಲಾಗಿದೆ. ನಾವು ನಿಖರತೆಯ ಬಗ್ಗೆ ಪ್ರಯತ್ನಿಸುವುದರಿಂದಾಗಿ, ದಯವಿಟ್ಟು ಗಮನಿಸಿ ಸ್ವಯಂಚಾಲಿತ ಅನುವಾದಗಳು ದೋಷಗಳು ಅಥವಾ ಅಸತ್ಯತೆಗಳು ಇರುವ ಸಾಧ್ಯತೆ ಇದೆ. ಮೂಲ ದಸ್ತಾವೇಜಿನ ಸ್ವತಂತ್ರ ಭಾಷೆಯಲ್ಲಿರುವ ಆವೃತ್ತಿಯೇ ನಂಬಿಕೆಯಷ್ಟು ಮೂಲವಾಗಿರಬೇಕು. ಮಹತ್ವದ ಮಾಹಿತಿಗಾಗಿ, ವೃತ್ತಿಪರ ಮಾನವ ಅನುವಾದವನ್ನು ಶಿಫಾರಸು ಮಾಡಲಾಗುತ್ತದೆ. ಈ ಅನುವಾದವನ್ನು ಬಳಕೆಮೂಲಾಗಿನ ಯಾವುದಾದರೂ ತಪ್ಪುರ್ಥಕತೆ ಅಥವಾ ತಪ್ಪು ವ್ಯಾಖ್ಯಾನಗಳಿಗೆ ನಾವು ಜವಾಬ್ದಾರರಲ್ಲ.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-02-06T12:16:06+00:00",
"translation_date": "2026-02-06T13:38:05+00:00",
"source_file": "AGENTS.md",
"language_code": "ml"
},

@ -2,27 +2,27 @@
## Project Overview
ഇത് തുടങ്ങിയവർക്കായി വെബ് ഡെവലപ്പ്മെന്റ് അടിസ്ഥാനങ്ങൾ പഠിപ്പിക്കുന്ന ഒരു വിദ്യാഭ്യാസ പാഠ്യപദ്ധതി സംഭരണിയാണിത്. Microsoft Cloud Advocates വികസിപ്പിച്ച സ്വരൂപായി 12 ആഴ്ച നീളുന്ന സമഗ്ര കോഴ്‌സ് ആണ്, ജാവാസ്ക്രിപ്റ്റ്, CSS, HTML എന്നിവ ഉൾപ്പെടുത്തി 24 ഹാൻഡ്സ്-ഓൺ പാഠങ്ങൾ ഇതിൽ ഉൾപ്പെടുത്തിയിട്ടുണ്ട്.
ഈ പ്രൊജക്ട് വെബ് ഡെവലപ്പ്മെന്റ് അടിസ്ഥാനങ്ങൾ ആരംഭക്കാർക്ക് പഠിപ്പിക്കുന്നതിന് ഒരു വിദ്യാഭ്യാസ പാഠ്യക്രമ റീപോസിറ്ററിയാണ്. മൈക്രോസോഫ്‌റ് ക്ലൗഡ് അഡ്വക്കേറ്റുകൾ വികസിപ്പിച്ച 12 ആഴ്ചകളായി വ്യാപിച്ചിട്ടുള്ള സമഗ്ര കോഴ്‌സ് ആണ് ഇത്, ജാവാസ്ക്രിപ്റ്റ്, CSS, HTML എന്നിവ ഉൾപ്പെടുന്ന 24 ഹാൻഡ്‌സ്-ഓൺ പാഠങ്ങൾ ഉൾക്കൊള്ളുന്നു.
### Key Components
- **വിദ്യാഭ്യാസ ഉള്ളടക്കം**: പ്രോജക്റ്റ് അടിസ്ഥാനമാക്കിയുള്ള മോഡ്യൂളുകളായി സംഘടിപ്പിച്ച 24 ഘടിപ്പിച്ച പാഠങ്ങൾ
- **പ്രായോഗിക പ്രോജക്റ്റുകൾ**: ടെറേറിയം, ടൈപ്പിംഗ് ഗെയിം, ബ്രൗസർ എക്സ്റ്റൻഷൻ, സ്പെയ്സ് ഗെയിം, ബാങ്കിംഗ് ആപ്പ്, കോഡ് എഡിറ്റർ, AI ചാറ്റ് അസിസ്റ്റന്റ്
- **ഇന്ററാക്ടീവ് ക്വിസുകൾ**: ഓരോ പാഠത്തിനും 3 ചോദ്യങ്ങളടങ്ങിയ 48 ക്വിസുകൾ (പ്രീ/പോസ്റ്റു-പാഠം മൂല്യനിർണയം)
- **ബഹുബാഷീയ പിന്തുണ**: GitHub Actions വഴി 50-ലധികം ഭാഷകളിലേക്ക് സ്വയം പരിഭാഷാക്കൽ
- **ടെക്നോളജികൾ**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI പ്രോജക്റ്റുകൾക്കായി)
- **വിദ്യാഭ്യാസ ഉള്ളടക്കം**: പ്രോജക്ട്-അധിഷ്ഠിത മൊഡ്യൂളുകളായി ക്രമീകരിച്ച 24 ഘടനാകൃത പാഠങ്ങൾ
- **പ്രായോഗിക പ്രോജക്ടുകൾ**: ടെറിയേറിയം, ടൈപ്പിംഗ് ഗെയിം, ബ്രൗസർ എക്‌സ്റ്റൻഷൻ, സ്‌പേസ് ഗെയിം, ബാങ്കിംഗ് ആപ്പ്, കോഡ് എഡിറ്റർ, AI ചാറ്റ് അസിസ്റ്റന്റ്
- **ഇന്ററാക്റ്റിവ് ക്വിസുകൾ**: ഓരോന്നിലും 3 ചോദ്യങ്ങളുള്ള 48 ക്വിസുകൾ (പ്രീ/പോസ്‌റ്റ് ലെസൻ അസസ്മെന്റുകൾ)
- **മൾട്ടി-ഭാഷാ പിന്തുണ**: GitHub Actions വഴി 50+ ഭാഷകളിലേക്ക് സ്വയംഭാഷാപരിവർത്തനം
- **സാങ്കേതികവിദ്യകൾ**: HTML, CSS, ജാവാസ്ക്രിപ്റ്റ്, Vue.js 3, Vite, Node.js, എക്‌സ്പ്രസ്, Python (AI പ്രോജക്ടുകൾക്കായി)
### Architecture
- പാഠം അധിഷ്ഠിത ഘടനയുള്ള വിദ്യാഭ്യാസ സംഭരണം
- ഓരോ പാഠ ഫോൾഡറിലും README, കോഡ് മാതൃകകൾ, പരിഹാരങ്ങൾ
- വ്യത്യസ്ത ഡയറക്ടറികളിൽ സ്വതന്ത്ര പ്രോജക്റ്റുകൾ (quiz-app, വിവിധ പാഠ പ്രോജക്റ്റുകൾ)
- GitHub Actions ഉപയോഗിച്ച പരിഭാഷാ സംവിധാനം (co-op-translator)
- Docsify വഴിയുള്ള ഡോക്യുമെന്റേഷൻ സെർവ് ചെയ്യപ്പെടുന്നു, PDF ആയി ലഭ്യമാണ
- ലെസൻ അടിസ്ഥാനത്തിലുള്ള ഘടനയുള്ള വിദ്യാഭ്യാസ റീപോസിറ്ററി
- ഓരോ ലെസൻ ഫോൾഡറിലും റീഡ്മി, കോഡ് ഉദാഹരണങ്ങൾ, പരിഹാരങ്ങൾ ഉണ്ട്
- പ്രത്യേക വിഭാഗങ്ങളിലുള്ള സ്വതന്ത്ര പ്രോജക്ടുകൾ (quiz-app, വിവിധ ലെസൻ പ്രോജക്ടുകൾ)
- GitHub Actions ഉപയോഗിച്ചും (co-op-translator) ശബ്ദാനുഭവം
- ഡോക്യുമെൻറേഷൻ Docsify വഴി സർവ് ചെയ്യുന്നു, PDF രൂപത്തിലാണ് ലഭ്യമാകുന്നത
## Setup Commands
സംഭരണം പ്രധാനമായും വിദ്യാഭ്യാസ ഉള്ളടക്കം ഉപഭോഗത്തിനാണ്. പ്രത്യേക പ്രോജക്റ്റുകളുമായി ജോലി ചെയ്യാൻ:
റീപോസിറ്ററി മുഖ്യമായും വിദ്യാഭ്യാസ ഉള്ളടക്കം ഉപഭോക്തൃത്ക്കായി ആണ്. നിശ്ചിത പ്രോജക്ടുകളുമായി ജോലി ചെയ്യാൻ:
### Main Repository Setup
@ -36,9 +36,9 @@ cd Web-Dev-For-Beginners
```bash
cd quiz-app
npm install
npm run dev # വികസന സെർവർ ആരംഭിക്കുക
npm run build # ഉൽപാദനത്തിനായി നിർമ്മിക്കുക
npm run lint # ESLint പ്രവർത്തിപ്പിക്കുക
npm run dev # ഡവലപ്പ്മെന്റ് സര്‍വര്‍ ആരംഭിക്കുക
npm run build # പ്രൊഡക്ഷന് വേണ്ടി ബില്‍ഡ് ചെയ്യുക
npm run lint # ESLint ഓടിക്കുക
```
### Bank Project API (Node.js + Express)
@ -56,7 +56,7 @@ npm run format # Prettier ഉപയോഗിച്ച് ഫോർമാറ
```bash
cd 5-browser-extension/solution
npm install
# ബ്രൗസർ-നിഷ്ചിതമായ വിപുലീകരണ ലോഡിംഗ് നിർദ്ദേശങ്ങൾ പിന്തുടരുക
# ബ്രൗസർ-വശ്ഭവമായ എക്സ്റ്റൻഷൻ ലോഡിംഗ് നിർദ്ദേശങ്ങൾ പാലിക്കുക
```
### Space Game Projects
@ -64,7 +64,7 @@ npm install
```bash
cd 6-space-game/solution
npm install
# index.html ബ്രൗസറിൽ തുറക്കുക അല്ലെങ്കിൽ ലവ് സർവർ ഉപയോഗിക്കുക
# ബ്രൗസറിൽ index.html തുറക്കുക അല്ലെങ്കിൽ ലവ് സർവർ ഉപയോഗിക്കുക
```
### Chat Project (Python Backend)
@ -72,7 +72,7 @@ npm install
```bash
cd 9-chat-project/solution/backend/python
pip install openai
# GITHUB_TOKEN പരിസ്ഥിതി ചാരാംശ സജ്ജമാക്കുക
# GITHUB_TOKEN പരിസ്ഥിതി ചിന്താരൂപ സജ്ജമാക്കുക
python api.py
```
@ -80,29 +80,29 @@ python api.py
### For Content Contributors
1. **ിപ്പോസിറ്ററി നിങ്ങളുടെ GitHub അക്കൗണ്ടിലേക്ക് Fork ചെയ്യുക**
2. **നിങ്ങളുടെ Fork ലോക്കലി Clone ചെയ്യുക**
3. **മാറുന്നതിനു പുതിയ ബ്രാഞ്ച് സൃഷ്ടിക്കുക**
4. പാഠ ഉള്ളടക്കം അല്ലെങ്കിൽ കോഡ് മാതൃകകളിൽ മാറ്റങ്ങൾ വരുത്തുക
5. ബന്ധപ്പെട്ട പ്രോജക്റ്റ് ഡയറക്ടറികളിൽ കോഡ് മാറ്റങ്ങൾ പരീക്ഷിക്കുക
6. സംഭാവന മാർഗനിർദ്ദേശങ്ങൾ പാലിച്ച് പുൾ റിക്വസ്റ്റ് നൽകുക
1. **ീപ്പോസിറ്ററി ഫോർക്ക് ചെയ്യുക** നിങ്ങളുടെ GitHub അക്കൗണ്ടിലേക്ക്
2. **ഫോർക്ക് ക്ലോൺ ചെയ്യുക** ലോക്കലിൽ
3. **പുതിയ ബ്രാഞ്ച് ഉണ്ടാക്കുക** നിങ്ങൾ ചെയ്ത മാറ്റങ്ങൾക്കു വേണ്ടി
4. ലെസൻ ഉള്ളടക്കം അല്ലെങ്കിൽ കോഡ് ഉദാഹരണങ്ങളിൽ മാറ്റങ്ങൾ വരുത്തുക
5. ബന്ധപ്പെട്ട പ്രോജക്് ഡയറക്ടറികളിൽ കോഡ് മാറ്റങ്ങൾ പരീക്ഷിക്കുക
6. സംഭാവനാ മാർഗ്ഗനിർദേശം അനുസരിച്ചു പുൾ റിക്വസ്റ്റുകൾ സമർപ്പിക്കുക
### For Learners
1. റിപ്പോസിറ്ററി Fork ആക്കുകയോ Clone ചെയ്യുകയോ ചെയ്യുക
2. പാഠ ഡയറക്ടറികളിലൂടെ ക്രമമായി പോകുക
3. ഓരോ പാഠത്തിനും README ഫയലുകൾ വായിക്കുക
4. https://ff-quizzes.netlify.app/web/ ന്‍പുതിയ പാഠം ആരംഭിക്കുന്നതിന് മുൻപ് ക്വിസുകൾ പൂർത്തിയാക്കുക
5. പാഠ ഫോൾഡറിലുള്ള കോഡ് മാതൃകകൾ വഴി പ്രവർത്തിക്കുക
6. അസൈൻമെന്റുകളും ചലഞ്ചുകളും പൂർത്തിയാക്കുക
7. പാഠം കഴിഞ്ഞുള്ള ക്വിസുകൾ കൈകാര്യം ചെയ്യുക
1. റീപോസിറ്ററി ഫോർക്ക് ചെയ്യുക അല്ലെങ്കിൽ ക്ലോൺ ചെയ്യുക
2. ലെസം ഡയറക്ടറികളിലൂടെ അനുക്രമണികമായി നടന്ന് പഠിക്കുക
3. ഓരോ പാഠത്തിനും README ഫയലുകൾ വായിക്കുക
4. https://ff-quizzes.netlify.app/web/ യിൽ പ്രീ-ലെസൻ ക്വിസുകൾ പൂർത്തിയാക്കുക
5. ലെസൻ ഫോൾഡറിലെ കോഡ് ഉദാഹരണങ്ങൾ ചുറ്റി പഠിക്കുക
6. അസൈന്മെന്റുകളും പരീക്ഷണങ്ങളും പൂർത്തിയാക്കുക
7. പോസ്റ്റ്-ലെസൻ ക്വിസുകൾ നടത്തുക
### Live Development
- **ഡോക്യുമെന്റേഷൻ**: റൂട്ടിൽ `docsify serve` പ്രവർത്തിപ്പിക്കുക (പോർട്ട് 3000)
- **Quiz App**: quiz-app ഡയറക്ടറിയിൽ `npm run dev` ക്ലിക്ക് ചെയ്യുക
- **Projects**: HTML പ്രോജക്റ്റുകൾക്കായി VS Code Live Server എക്സ്റ്റൻഷൻ ഉപയോഗിക്കുക
- **API Projects**: ബന്ധപ്പെട്ട API ഡയറക്ടറികളിൽ `npm start` പ്രവർത്തിപ്പിക്കുക
- **ഡോക്യുമെൻറേഷൻ**: റൂട്ട് വിഭാഗത്തിൽ `docsify serve` ഓടിക്കുക (പോർട്ട് 3000)
- **Quiz App**: quiz-app ഡയറക്ടറിയിൽ `npm run dev` ഓടിക്കുക
- **പ്രോജക്ടുകൾ**: HTML പ്രോജക്ടുകൾക്ക് VS Code ലൈവ് സർവർ എക്‌സ്‌റ്റൻഷൻ ഉപയോഗിക്കുക
- **API Projects**: ബന്ധപ്പെട്ട API ഡയറക്ടറിയിൽ `npm start` ഓടിക്കുക
## Testing Instructions
@ -110,7 +110,7 @@ python api.py
```bash
cd quiz-app
npm run lint # കോഡ് സ്റ്റൈൽ പ്രശ്നങ്ങൾ പരിശോധിക്കുക
npm run lint # കോഡ് ശൈലി പ്രശ്‌നങ്ങൾ പരിശോധിക്കുക
npm run build # ബിൽഡ് വിജയകരമാണെന്ന് ഉറപ്പാക്കുക
```
@ -118,165 +118,165 @@ npm run build # ബിൽഡ് വിജയകരമാണെന്ന്
```bash
cd 7-bank-project/api
npm run lint # കോഡ് ശൈലി പ്രശ്നങ്ങൾ പരിശോധിക്കുക
node server.js # സർവർ പിശകുകൾ ഇല്ലാതെ ആരംഭിക്കുന്നുവെന്ന് സ്ഥിരീകരിക്കുക
npm run lint # കോഡ് സ്റ്റൈൽ പ്രശ്നങ്ങൾ പരിശോധിക്കുക
node server.js # എത്രവു തെറ്റുകളില്ലാതെ സെർവർ ആരംഭിക്കുന്നത് ഉറപ്പാക്കുക
```
### General Testing Approach
- ഇത് സമഗ്ര സ്വയംപരിശോധന പരീക്ഷണങ്ങളില്ലാത്ത ഒരു വിദ്യാഭ്യാസ സംഭരണിയാണ്
- മാനുവൽ ടെസ്റ്റിങ് താഴെ കാണുന്നവയിൽ ഊന്നി നടത്തുന്നു:
- കോഡ് മാതൃകകൾ പാളാതെ പ്രവർത്തിക്കുന്നു
- ഡോക്യുമെന്റേഷൻ ലിങ്കുകൾ ശരിയായി പ്രവർത്തിക്കുന്നു
- പ്രോജക്റ്റ് ബിൽഡുകൾ വിജയകരമായി പൂർത്തിയാകുന്നു
- മാതൃകകൾ മികച്ച പ്രവൃത്തികൾ പിന്തുടരുന്നു
- ഇത് സമഗ്രമായ സ്വയംപരിശോധനയുള്ള ഒരു വിദ്യാഭ്യാസ റീപ്പോസിറ്ററിയല്ല
- മാനുവൽ ടെസ്റ്റിങ്ങ് ശ്രദ്ധ കേന്ദ്രീകരിക്കുന്നത്:
- കോഡ് ഉദാഹരണങ്ങൾ പിശകുകളില്ലാതെ പ്രവർത്തിക്കുന്നു
- ഡോക്യുമെൻറേഷനിൽ ഉള്ള ലിങ്കുകൾ ശരിയായി പ്രവര്‍ത്തിക്കുന്നു
- പ്രോജക്ട് ബിൽഡുകൾ വിജയകരമായി പൂര്‍ത്തീകരിക്കുന്നു
- ഉദാഹരണങ്ങൾ മികച്ച പ്രവർത്തനരീതികളെ പിന്തുടരുന്നു
### Pre-submission Checks
- `package.json` ഉള്ള ഡയറക്ടറികളിൽ `npm run lint` നടത്തുക
- മാർക്‌ഡൗൺ ലിങ്കുകൾ ശരിയായെന്ന് പരിശോധിക്കുക
- ബ്രൗസർ അല്ലെങ്കിൽ Node.jsൽ കോഡ് മാതൃകകൾ പരീക്ഷിക്കുക
- പരിഭാഷകൾ ശരിയായ ഘടന പാലിക്കുന്നുണ്ടോ എന്ന് പരിശോധിക്കുക
- package.json ഉള്ള ഡയറക്ടറികളിൽ `npm run lint` ഓടിക്കുക
- മാർക്ക്ഡൗൺ ലിങ്കുകൾ സാധുവാണെന്ന് സ്ഥിരീകരിക്കുക
- ബ്രൗസറിലും Node.js ലും കോഡ് ഉദാഹരണങ്ങൾ പരിശോധിക്കുക
- വിവർത്തനങ്ങളുടെ ഘടന ശരിയാണെന്ന് ഉറപ്പാക്കുക
## Code Style Guidelines
### JavaScript
- ആധുനിക ES6+ സിന്റാക്സ് ഉപയോഗിക്കുക
- പ്രോജക്റ്റുകളിൽ നൽകിയ സ്റ്റാൻഡേർഡ് ESLint കോൺഫിഗറേഷനുകൾ പിന്തുടരുക
- വിദ്യാഭ്യാസ പരിസരത്തിൽ മനസ്സിലാകുന്നതിന് പ്രാധാന്യമുള്ള മൂല്യനാമങ്ങൾ, ഫംഗ്ഷൻ പേരുകൾ ഉപയോഗിക്കുക
- പഠനാർത്ഥികൾക്കായി ആശയങ്ങൾ വിശദമാക്കുന്ന കമന്റുകൾ ചേർക്കുക
- Prettier ഉപയോഗിച്ച് ഫോർമാറ്റ് ചെയ്യുക (കോൺഫിഗർ ചെയ്യപ്പെട്ടിടത്ത്)
- ആധുനിക ES6+ സിന്തക്സ് ഉപയോഗിക്കുക
- പ്രോജക്ടുകളിൽ നൽകിയ സെർബന്ധമായ ESLint ക്രമീകരണങ്ങൾ പിന്തുടരുക
- വിദ്യാഭ്യാസ ക്ലാരിറ്റിക്കായി അർത്ഥപൂർണ്ണ变量-ഫംഗ്ഷൻ നാമങ്ങൾ ഉപയോഗിക്കുക
- പഠനാർത്ഥികൾക്കായി ആശയങ്ങൾ വിശദീകരിക്കുന്ന കമന്റുകൾ ചേർക്കുക
- Prettier ഉപയോഗിച്ച് സജ്ജീകരിച്ചിട്ടുണ്ടെങ്കിൽ ഫോർമാറ്റ് ചെയ്‌തു
### HTML/CSS
- സമാന്റിക് HTML5 ഘടകങ്ങൾ
- പ്രതികരണശീലമുള്ള (responsive) ഡിസൈൻ സിദ്ധാന്തങ്ങൾ
- വ്യക്തമായ ക്ലാസ് നാമകരണം
- CSS സാങ്കേതിക വിദ്യകൾ വിശദമാക്കുന്ന കമന്റുകൾ
- സമാന്റിക് HTML5 ഘടകങ്ങൾ
- റെസ്പോൺസീവ് ഡിസൈൻ സിദ്ധാന്തങ്ങൾ
- വ്യക്തമായ ക്ലാസ് നാമകരണം
- CSS സാങ്കേതികവിദ്യകൾ വിശദീകരിക്കുന്ന കമന്റുകൾ
### Python
- PEP 8 സ്റ്റൈൽ ഗൈഡുകളുടെ അനുസരണം
- വ്യക്തവും വിദ്യാഭ്യാസപരവുമായ കോഡ് മാതൃകകൾ
- പഠന സഹായത്തിനായി ടൈപ്പ് സൂചനകൾ ഉപയോഗിക്കുക
- PEP 8 ശൈലി മാർഗ്ഗനിർദേശങ്ങൾ
- വ്യക്തവും വിദ്യാഭ്യാസ ആവശ്യകതകൾക്കനുസൃതവുമായ കോഡ് ഉദാഹരണങ്ങൾ
- പഠനത്തിനെ സഹായിക്കുന്നിടത്ത് ടൈപ്പ് ഹിന്റുകൾ
### Markdown Documentation
- വ്യക്തമായ ഹെഡിംഗിന്റെ ക്രമീകരണം
- ഭാഷാ വിശദീകരണത്തോടെയുള്ള കോഡ് ബ്ലോക്കുകൾ
- അധിക റിസോഴ്‌സുകളിലേക്കുള്ള ലിങ്കുകൾ
- `images/` ഫോളഡറിലെ സ്‌ക്രീൻഷോട്ടുകളും ചിത്രങ്ങളും
- ആക്‌സസ് സുഖവത്ക്കരണത്തിനായി ചിത്രങ്ങൾക്ക് അൾട്ട് ടെക്‌സ്‌റ്റ് നൽകുക
- വ്യക്തമായ തലക്കെട്ട് ക്രമീകരണം
- ഭാഷാ സൂചനയടങ്ങിയ കോഡ് ബ്ലോക്കുകൾ
- അധിക ഉറവിടങ്ങളുടെ ലിങ്കുകൾ
- `images/` ഡയറക്ടറിയിലുള്ള സ്ക്രീൻഷോട്ടുകളും ചിത്രങ്ങളും
- ആക്‌സസിബിലിറ്റിക്ക് ചിത്രങ്ങൾക്ക് ఆల്ട് ടെക്സ്റ്റ്
### File Organization
- പാഠങ്ങൾ കൃത്യമായ നമ്പറിങ്ങോടെ ക്രമീകരിക്കുക (1-getting-started-lessons, 2-js-basics, തുടങ്ങിയവ)
- ഓരോ പ്രോജക്റ്റിനും `solution/`, അധികമായി `start/` അല്ലെങ്കിൽ `your-work/` ഡയറക്ടറികൾ
- ചിത്രങ്ങൾ പാഠത്തിന് അനുയോജ്യമായ `images/` ഫോൾഡറിൽ സൂക്ഷിക്കുക
- പരിഭാഷക`translations/{language-code}/` ഘടനയിൽ
- പാഠങ്ങൾ ക്രമികൃത നമ്പറിലുള്ള ഡയറക്ടറികളായി (1-getting-started-lessons, 2-js-basics, മുതലായവ)
- ഓരോ പ്രോജക്ടിനും `solution/` ഉം പലപ്പോഴും `start/` അല്ലെങ്കിൽ `your-work/` ഡയറക്ടറികളും
- ചിത്രങ്ങൾ പാഠനിർദ്ദേശമായ `images/` ഫോൾഡറുകളില്‍ സൂക്ഷിക്കുന്നു
- വിവർത്തനങ്ങ`translations/{language-code}/` ഘടനയിൽ
## Build and Deployment
### Quiz App Deployment (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 വർക്ക്‌ഫ്ലോ വഴി വിന്യസിക്കുന്നു
# മെയിനിലേക്ക് പുഷ് ചെയ്യുമ്പോൾ GitHub Actions workflow വഴി ഡിപ്ലോയു ചെയ്യുന്നു
```
Azure Static Web Apps ക്രമീകരണം:
- **അപ് ലൊക്കേഷൻ**: `/quiz-app`
- **ഔട്ട്പുട്ട് ലൊക്കേഷൻ**: `dist`
- **ർക്ക്‌ഫ്ലോ**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
Azure Static Web Apps കോൺഫിഗറേഷൻ:
- **ആപ്പ് സ്ഥലം**: `/quiz-app`
- **ഔട്ട്പുട്ട് സ്ഥലം**: `dist`
- **ര്‍ക്ക്ഫ്ലോ**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Documentation PDF Generation
```bash
npm install # docsify-to-pdf ഇൻസ്റ്റാൾ ചെയ്യുക
npm run convert # ഡോക്‌സ് ആണ് നിന്ന് PDF എടുക്കുക
npm run convert # ഡോക്‌സിൽ നിന്ന് PDF സൃഷ്ടിക്കുക
```
### Docsify Documentation
```bash
npm install -g docsify-cli # Docsify സ്ഥാപിക്കുക സാർവദ്ദേശികമായി
docsify serve # localhost:3000-ൽ സർവ് ചെയ്യുക
npm install -g docsify-cli # Docsify ആഗോളമായി ഇൻസ്റ്റാൾചെയ്യുക
docsify serve # localhost:3000-ൽ സർവ് ചെയ്യുക
```
### Project-specific Builds
ഓരോ പ്രോജക്റ്റ് ഡയറക്ടറിയിലും സ്വന്തം ബിൽഡ് പ്രക്രിയ ഉണ്ടായിരിക്കാം:
- Vue പ്രോജക്റ്റുകൾ: `npm run build` ഉപയോഗിച്ച് പ്രൊഡക്ഷൻ বান്ടിൽ സൃഷ്ടിക്കുന്നു
- സ്റ്റാറ്റിക് പ്രോജക്റ്റുകൾ: ബിൽഡ് ഘട്ടമില്ല, ഫയലുകൾ നേരിട്ട് സര്‍വ് ചെയ്യുന്നു
ഓരോ പ്രോജക്ടിനും തനിക്ക് പ്രത്യേകം ബിൽഡ് പ്രക്രിയ ഉണ്ടായേക്കാം:
- Vue പ്രോജക്ടുകൾ: `npm run build` ഉൽപ്പാദന ബണ്ടിലുകൾ ഉരുത്തിരിക്കുന്നു
- സ്റ്റാറ്റിക് പ്രോജക്ുകൾ: ബിൽഡ് ഘട്ടമില്ല, ഫയലുകൾ നേരിട്ട് സവ് ചെയ്യുന്നു
## Pull Request Guidelines
### Title Format
മാറ്റത്തിന്റെ പ്രദേശം വ്യക്തം ചെയ്യുന്ന സ്ഥിരീകരണശീർഷകങ്ങൾ ഉപയോഗിക്കുക:
- `[Quiz-app] പാഠം X-നായി പുതിയ ക്വിസ് ചേർക്കുക`
- `[Lesson-3] ടെറേറിയം പ്രോജക്റ്റിലെ ടൈപ്പോ തിരുത്തുക`
- `[Translation] പാഠം 5-നുള്ള സ്പാനിഷ് പരിഭാഷ ചേർക്കുക`
- `[Docs] സെറ്റപ്പ് നിർദ്ദേശങ്ങൾ അപ്ഡേറ്റ് ചെയ്യുക`
മാറ്റത്തിന്റെ പ്രദേശം സൂചിപ്പിക്കുന്ന വ്യക്തമായ, വിവരണപരമായ തലക്കെട്ടുകൾ ഉപയോഗിക്കുക:
- `[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`
### Required Checks
PR സമർപ്പിക്കുന്നതിന് മുൻപ്:
ഫുൾ പുൾ റിക്വസ്റ്റ് സമർപ്പിക്കുന്നതിന് മുൻപ്:
1. **കോഡ് ഗുണമേൻമ**:
- ബാധിത പ്രോജക്റ്റ് ഡയറക്ടറികളിൽ `npm run lint` നടത്തുക
- എല്ലാ ലിന്റിംഗ് തെറ്റുകൾക്കും മുന്നറിയിപ്പുകൾക്കും പരിഹാരം കാണിക്കുക
1. **കോഡ് ഗുണമേന്മ**:
- ബാധിച്ച പ്രോജക്ട് ഡയറക്ടറികളിൽ `npm run lint` ഓടിക്കുക
- എല്ലാ ലിന്റിംഗ് പിഴവുകളും മുന്നറിയിപ്പുകളും തിരുത്തുക
2. **ബിൽഡ് സ്ഥിരീകരണം**:
- ആവശ്യാനുസരണം `npm run build` നടത്തുക
- ബിൽഡ് പിശകുകൾ ഇല്ലെന്ന് ഉറപ്പാക്കുക
2. **ബിൽഡ് സ്ഥിരീകരണം**:
- ചേരുന്നതാണെങ്കിൽ `npm run build` ഓടിക്കുക
- ബിൽഡ് പിഴവുകൾ ഉണ്ടാകാതിരിക്കണം
3. **ലിങ്ക് പരിശോധന**:
- എല്ലാ മാർക്‌ഡൗൺ ലിങ്കുകളും പരീക്ഷിക്കുക
- ചിത്രങ്ങളുടെ റഫറൻസുകൾ ശരിയായ നിലയിലാണ് നോക്കുക
3. **ലിങ്ക് പരിശോധന**:
- എല്ലാ മാർക്ക്‌ഡൗൺ ലിങ്കുകളും ടെസ്റ്റ് ചെയ്യുക
- ചിത്ര സൂചനകൾ ശരിയാണെന്നും ഉറപ്പാക്കുക
4. **ഉള്ളടക്ക അവലോകനം**:
- ശരിയായ വാചകം, വ്യാകരണം മുൻനിർത്തി പ്രൂഫ് രാത്രി നടത്തുക
- കോഡ് മാതൃകകൾ ഉചിതവും വിദ്യാഭ്യാസ അനുയോജ്യവുമാണ് എന്ന ഉറപ്പാക്കുക
- പരിഭാഷകൾ യഥാർത്ഥ അർത്ഥം പേടിക്കാത്ത രീതിയിൽ എന്നിവ പരിശോധിക്കുക
4. **ഉള്ളടക്ക പരിശോധന**:
- വ്യാകരണപിശകുകൾ, പകർച്ചവ്യാധി പരിശോധിക്കുക
- കോഡ് ഉദാഹരണങ്ങൾ ശരിയായും വിദ്യാഭ്യാസോപകാരികളായും ഉറപ്പാക്കുക
- വിവർത്തനങ്ങൾ യാഥാർത്ഥ്യാർത്ഥവും സാംസ്‌കാരികമായും ശരിയാണെന്ന് പരിശോധിക്കുക
### Contribution Requirements
- Microsoft CLA (പ്രഥമ PR-ൽ സ്വയം പരിശോധന) അംഗീകരിക്കുക
- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) അനുസരിക്കുക
- വിശദമായ മാർഗനിർദ്ദേശങ്ങൾക്കായി [CONTRIBUTING.md](./CONTRIBUTING.md) കാണുക
- പ്രാസക്തമായെങ്കിൽ PR വിവരണത്തിൽ issue നമ്പറുകൾ ഉൾപ്പെടുത്തുക
- Microsoft CLA അംഗീകരിക്കുക (ആശയപ്പെടുത്തൽ ഓട്ടോമാറ്റിക്കായി ആദ്യ PR)
- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) പാലിക്കുക
- വിശദാംശങ്ങൾക്കായി [CONTRIBUTING.md](./CONTRIBUTING.md) കാണുക
- ആവശ്യമായാൽ PR വിവരണത്തിൽ ഇഷ്യൂ നമ്പറുകൾ റഫറൻസ് ചെയ്യുക
### Review Process
- PR-കൾ വഹിക്കുന്നവർ மற்றும் സമൂഹം പരിശോധിക്കും
- വിദ്യാഭ്യാസ സ്പഷ്ടതക്ക് മുൻഗണന നൽകും
- കോഡ് മാതൃകകൾ നിലവിലുള്ള മികച്ച രീതികൾ പാലിക്കണം
- പരിഭാഷകൾ കൃത്യതയും സാംസ്കാരികാനുസൃതിയും മുന്നിൽവയ്ക്കു
- PR പരിരക്ഷകന്‍മാർക്കും സമൂഹത്തിനും അടിയന്തരമായി പരിശോധിക്കപ്പെടുന്നു
- വിദ്യാഭ്യാസ കൂടുതൽ പ്രാഥമ്യമാണ്
- കോഡ് ഉദാഹരണങ്ങൾ നിലവിലുള്ള മികച്ച പ്രവർത്തനരീതികൾ പിന്തുടരണം
- വിവർത്തനങ്ങൾ കൃത്യതയോടും സാംസ്‌കാരിക അനുയോജ്യതയോടും കൂടിയവ ആകണ
## Translation System
### Automated Translation
- GitHub Actions സെറ്റ് ചെയ്ത co-op-translator വർക്‌ഫ്ലോ ഉപയോഗിക്കുന്നു
- 50-ൽ പരം ഭാഷകളിലേക്ക് സ്വയം പരിഭാഷകൾ നൽകുന്നു
- പ്രധാന ഡയറക്ടറികളിലുള്ള സോഴ്‌സ് ഫയലുകൾ
- `translations/{language-code}/` ലെ പരിഭാഷ ഫയലുകൾ
- GitHub Actions ഉപയോഗിച്ച് co-op-translator വർക്ക്ഫ്ലോ നടത്തുന്നു
- 50+ ഭാഷകളിലേക്ക് സ്വയംഭാഷാപരിവർത്തനം
- പ്രധാന ഡയറക്ടറികളിലെ ഉറവിട ഫയലുകൾ
- `translations/{language-code}/` ഡയറക്ടറികളിലെ വിവർത്തന ഫയലുകൾ
### Adding Manual Translation Improvements
1. `translations/{language-code}/` എന്നിൽ ഫയൽ കണ്ടെത്തുക
2. ഘടന പരിപാലിച്ച് മെച്ചപ്പെടുത്തലുകൾ വരുത്തുക
3. കോഡ് മാതൃകകൾ പ്രവർത്തനക്ഷമമാവുന്നുവെന്ന് ഉറപ്പാക്കുക
4. ലൊക്കലൈസ്ഡ് ക്വിസ് ഉള്ളടക്കം പരീക്ഷിക്കുക
1. `translations/{language-code}/` ൽ ഫയൽ കണ്ടെത്തുക
2. ഘടന നിലനിർത്തി മെച്ചപ്പെടുത്തലുകൾ ചെയ്യുക
3. കോഡ് ഉദാഹരണങ്ങൾ പ്രവർത്തനശീലമാകണം
4. ലൊക്കലൈസ്ഡ് ക്വിസ് ഉള്ളടക്കം പരീക്ഷിക്കുക
### Translation Metadata
പരിഭാഷാ ഫയലുകളിൽ താഴെപ്രകാരമുള്ള മെറ്റാഡാറ്റ ഹെഡർ ഉണ്ടാകും:
വിവർത്തിത ഫയലുകൾ മെടാഡേറ്റാ ഹെഡർ ഉൾക്കൊള്ളുന്നു:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -293,116 +293,116 @@ CO_OP_TRANSLATOR_METADATA:
### Common Issues
**Quiz app ആരംഭിക്കാൻ ബുദ്ധിമുട്ടുന്നു**:
- Node.js വേർഷൻ പരിശോധിക്കുക (v14+ ശുപാർശ)
- `node_modules` വിദഗ്ധം, `package-lock.json` ഇല്ലാതാക്കി വീണ്ടും `npm install` ചെയ്യുക
- പോർട്ട് കോൺഫ്‌ളിക്ട് പരിശോധിക്കുക (സ്വഭാവികമായി Vite പോർട്ട് 5173 ആണ്)
**Quiz app ആരംഭിക്കാത്തത്**:
- Node.js പതിപ്പ് പരിശോധിക്കുക (v14+ ശുപാർശ ചെയ്യുന്നു)
- `node_modules`യും `package-lock.json`ഉം ഇല്ലാതാക്കി വീണ്ടും `npm install` റൺ ചെയ്യുക
- പോർട്ട് കോൺഫ്ലിക്റ്റ് പരിശോധിക്കുക (ഡിഫോൾട്ട്: Vite പോർട്ട് 5173 ഉപയോഗിക്കുന്നു)
**API സർവർ ആരംഭിക്കുന്നില്ല**:
- Node.js വേർഷൻ (നൂലുവും) കിട്ടുമോയെന്ന് പരിശോധിക്കുക (node >=10)
- പോർട്ട് വాడാ നേതൃത്വത്തിലാണോ എന്ന് നോക്കുക
- എല്ലാ ആശ്രിതങ്ങ`npm install` വഴി ഇൻസ്റ്റാൾ ചെയ്തുവെന്ന് ഉറപ്പാക്കുക
**API സെർവർ ആരംഭിക്കാത്തത്**:
- Node.js പതിപ്പ് (node >=10) തയ്യാറാണെന്ന് ഉറപ്പാക്കുക
- പോർട്ട് ഉപയോഗത്തിൽ ഇല്ലാത്തതായി പരിശോധിക്കുക
- എല്ലാ ആശ്രിതങ്ങളും `npm install` മുഖേന ഇൻസ്റ്റാൾ ചെയ്തിട്ടുണ്ടെന്ന് ഉറപ്പാക്കുക
**Browser extension ലോഡ് ആവുന്നില്ല**:
- manifest.json ശരിയായി രൂപപ്പെടുത്തിയിട്ടുണ്ടോ എന്ന് പരിശോധിക്കുക
- ബ്രൗസർ കോൺസോളിൽ പിശക് സന്ദേശങ്ങൾ കാണുക
- ബ്രൗസർ വ്യത്യസ്ത ഇങ്ങനെ സ്ഥാപിക്കൽ നിർദ്ദേശങ്ങൾ പാലിക്കുക
**Browser extension ലോഡ് ആവാത്തത്**:
- manifest.json ശരിയായി ഫോർമാറ്റ് ചെയ്തിട്ടുണ്ടോ എന്ന് പരിശോധിക്കുക
- ബ്രൗസർ കോൺസോളിൽ പിഴവുകൾ പരിശോധിക്കുക
- ബ്രൗസർ-നിഷ്ഠമായ എക്‌സ്റ്റൻഷൻ ഇൻസ്റ്റലേഷൻ നിർദ്ദേശങ്ങൾ പിന്‍ബന്ധിക്കുക
**Python ചാറ്റ് പ്രോജക്റ്റ് പ്രശ്നങ്ങൾ**:
- OpenAI പാക്കേജ് ഇൻസ്റ്റാൾ ചെയ്തിട്ടുണ്ടോ: `pip install openai`
- GITHUB_TOKEN എൻവയോൺമെന്റ് വെറിയബിള്‍ ക്രമീകരിച്ചതാണെന്ന് പരിശോധിക്കുക
- GitHub Models ആക്‌സസ് അനുമതികൾ ശരിയാണെന്ന് ഉറപ്പാക്കുക
**Python ചാറ്റ് പ്രോജക്ട് പ്രശ്നങ്ങൾ**:
- OpenAI പാക്കേജ് ഇൻസ്റ്റാൾ ചെയ്തിട്ടുണ്ടോ: `pip install openai`
- GITHUB_TOKEN എൻവയോൺമെന്റ് വേരിയബിൾ സജ്ജമാക്കപ്പെട്ടിട്ടുണ്ടോ
- GitHub മോഡൽ ആക്‌സസ് അനുമതികൾ പരിശോധിക്കുക
**Docsify ഡോക്സ് സർവ് ചെയ്യണമെങ്കിൽ**:
- docsify-cli ക്ളോബിൾ ആയി ഇൻസ്റ്റാൾ ചെയ്യുക: `npm install -g docsify-cli`
- റിപ്പോസിറ്ററി റൂട്ടിൽ നിന്നു പ്രവർത്തിപ്പിക്കുക
- `docs/_sidebar.md` ഉണ്ട് എന്ന് പരിശോധിക്കുക
**Docsify ഡോക്യുമെൻറേഷൻ സർവ് ചെയ്യാതെ പോകുന്നത്**:
- docsify-cli ഗ്ലോബലായി ഇൻസ്റ്റാൾ ചെയ്യുക: `npm install -g docsify-cli`
- റീപോസിറ്ററി മൂല ഡയറക്ടറിയിൽ നിന്നു റൺ ചെയ്യുക
- `docs/_sidebar.md` файл നാസ്‌തിയാണെങ്കിൽ പരിശോധിക്കുക
### Development Environment Tips
- HTML പ്രോജക്റ്റുകളിൽ VS Code Live Server എക്സ്റ്റൻഷൻ ഉപയോഗിക്കുക
- സ്ഥിരത പാലിക്കാനായി ESLint, Prettier എക്സ്റ്റൻഷനുകൾ ഇൻസ്റ്റാൾ ചെയ്യുക
- ജാവാസ്ക്രിപ്റ്റ് ഡിബഗ് ചെയ്യുന്നതിനായി ബ്രൗസർ DevTools ഉപയോഗിക്കുക
- Vue പ്രോജക്റ്റുകൾക്കായി Vue DevTools ബ്രൗസർ എക്സ്റ്റൻഷൻ ഇൻസ്റ്റാൾ ചെയ്യുക
- HTML പ്രോജക്ടുകൾക്കായി VS Code ലൈവ് സർവർ എക്‌സ്‌റ്റൻഷൻ ഉപയോഗിക്കുക
- ഏകീകൃത ഫോർമാറ്റിംഗിന് ESLint, Prettier എക്‌സ്‌റ്റൻഷനുകൾ ഇൻസ്റ്റാൾ ചെയ്യുക
- ജാവാസ്ക്രിപ്റ്റ് ഡീബഗിംഗിനായി ബ്രൗസർ DevTools ഉപയോഗിക്കുക
- Vue പ്രോജക്ുകൾക്കായി Vue DevTools ബ്രൗസർ എക്സ്റ്റൻഷൻ ഇൻസ്റ്റാൾ ചെയ്യുക
### Performance Considerations
- 50-ലധികം ഭാഷകളിലുള്ള വലിയ പരിഭാഷാ ഫയൽ എണ്ണം ഗിറ്റിന്റെ മുഴുവൻ ക്ലോണുകൾ വലിയതാക്കും
- ഉള്ളടക്കത്തിൽ മാത്രം പ്രവർത്തിക്കാനായി ശാലോ ക്ലോൺ ചെയ്യുക: `git clone --depth 1`
- ഇംഗ്ലീഷ് ഉള്ളടക്കത്തിൽ ജോലി നടത്തുമ്പോൾ പരിഭാഷകൾ തിരച്ചില്ലിൽ നിന്ന് ഒഴിവാക്കുക
- npm ഇൻസ്റ്റാൾ, Vite ബിൽഡ് തുടങ്ങിയ ആദ്യ പ്രവർത്തനങ്ങൾ ഇത് സ്ലോ ആയി ആകാൻ സാധ്യത
- 50+ ഭാഷകളിലുള്ള വിവർത്തന ഫയലുകളുടെ വലിയ എണ്ണം മൂലം ഫുൾ ക്ലോണുകൾ വലുതായി ആകും
- ഉള്ളടക്കത്തിൽ മാത്രം ജോലി ചെയ്യുകയാണെങ്കിൽ ശാലോ ക്ലോൺ ചെയ്യുക: `git clone --depth 1`
- ഇംഗ്ലീഷ് ഉള്ളടക്കത്തിൽ ജോലി ചെയ്യുമ്പോൾ വിവർത്തനങ്ങൾ തിരച്ചിൽമൂലങ്ങളിൽ ഒഴിവാക്കുക
- പ്രഥമ ഓടൽ സമയത്ത് (npm install, Vite build) ബിൽഡ് പ്രക്രിയകൾ മന്ദഗതിയുള്ളതാകാം
## Security Considerations
### Environment Variables
- API കീകൾ ഒരിക്കലും റിപ്പോസിറ്ററിയിലേക്ക് കമ്മിറ്റ് ചെയ്യരുത്
- `.env` ഫയലുകൾ ഉപയോഗിക്കുക (ഇത് `.gitignore` ല്‍ ഉൾപ്പെടുത്തിയിട്ടുണ്ട്)
- ആവശ്യമായ എൻവയോൺമെന്റ് വെറിയബിൾസ് പ്രോജക്റ്റ് README-കളിൽ രേഖപ്പെടുത്തുക
- API കീകൾ ഒരിക്കലും റപോസിറ്ററിയിലേക്ക് കമ്മിറ്റ് ചെയ്യരുത്
- `.env` ഫയലുകൾ ഉപയോഗിക്കുക (ഇ`.gitignore`യിൽ ഉൾപ്പെടുത്തിയിട്ടുണ്ട്)
- ആവശ്യമായ എൻവയോൺമെന്റ് വേരിയബിളുകൾ പ്രോജക്ട് README-യിൽ രേഖപ്പെടുത്തുക
### Python Projects
- വെർച്ച്വൽ എൻവയോൺമെന്റുകൾ ഉപയോഗിക്കുക: `python -m venv venv`
- ആശ്രിതങ്ങൾ പുതുക്കി നിലനിർത്തുക
- GitHub ടോകണുകൾ കുറഞ്ഞ അനുമതികളോടെ മാത്രം നൽകുക
- വെർച്വൽ എൻവയറൺമെന്റുകൾ ഉപയോഗിക്കുക: `python -m venv venv`
- ആശ്രിതങ്ങൾ അപ്ഡേറ്റ് ചെയ്ത് നിലനിറുത്തുക
- GitHub ടോകൺസ് കുറഞ്ഞ അനുവാദങ്ങളോടെ ആയിരിക്കണം
### GitHub Models Access
- GitHub മോഡലുകൾക്കായി Personal Access Tokens (PAT) ആവശ്യമാണ്
- ടോകണുകൾ എൻവയോൺമെന്റ് വെറിയബിൾസായി മാത്രമേ സൂക്ഷിക്കാവൂ
- ടോകണുകളും ക്രെഡൻഷ്യലുകളും ഒരിക്കലും കമ്മിറ്റ് ചെയ്യരുത്
- GitHub മോഡലുകൾക്കായി വ്യക്തിഗത ആക്‌സസ് ടോകൺസ് (PAT) ആവശ്യമാണ്
- ടോകൺസ് എൻവയോൺമെന്റ് വേരിയബിളുകൾ ആയി സൂക്ഷിക്കുക
- ടോകൺസ് അല്ലെങ്കിൽ ക്രെഡൻ‌ഷ്യലുകൾ ഒരിക്കലും കമ്മിറ്റ് ചെയ്യരുത്
## Additional Notes
### Target Audience
- വെബ് ഡെവലപ്പ്മെന്റിൽ പൂർത്തിയായ തുടക്കക്കാർ
- വിദ്യാർത്ഥികൾ, സ്വയം പഠിക്കുന്നവർ
- ക്ലാസിൽ പാഠമുറിവുകൾ ഉപയോഗിക്കുന്ന അധ്യപകർ
- ആക്‌സസ്സിബിലിറ്റിക്കും കൃത്യമായ കഴിവുയർത്തലിനും രൂപകൽപ്പന ചെയ്ത ഉള്ളടക്കം
- വെബ് ഡെവലപ്പ്മെന്റിൽ പുതിയവർക്ക്
- വിദ്യാർത്ഥികൾക്കും സ്വയംഅധ്യാപകർക്കും
- ക്ലാസിൽ ഈ പാഠ്യക്രമം ഉപയോഗിക്കുന്ന അധ്യപകർ
- ആക്സസ് ബിലിറ്റി പരിഗണിച്ചും നൈപുണ്യവികസനത്തിനും രൂപകൽപ്പന ചെയ്ത ഉള്ളടക്കം
### Educational Philosophy
- പ്രോജക്റ്റ് അടിസ്ഥാന പഠന രീതി
- നിരന്തര അറിവ് പരിശ്രമങ്ങൾ (ക്വിസുകൾ)
- ഹാൻഡ്സ്-ഓൺ കോഡിംഗ് അഭ്യാസങ്ങൾ
- യാഥാർത്ഥ്യ ആപ്ലിക്കേഷൻ ഉദാഹരണങ്ങൾ
- ഫ്രെയിംവർക്ക് തുടങ്ങുന്നതിന് മുമ്പ് അടിസ്ഥാനങ്ങൾ ശക്തമാക്കുക
- പ്രോജക്ട്-അധിഷ്ഠിത പഠന രീതി
- പതിവായി അറിവ് പരിശോധന (ക്വിസുകൾ)
- പ്രായോഗിക കോഡിങ് അഭ്യാസങ്ങൾ
- യാഥാർത്ഥ്യത്തിലെ പ്രയോഗ ഉദാഹരണങ്ങൾ
- ഫ്രെയിംവർക്ക് മുമ്പുള്ള അടിസ്ഥാനങ്ങളിൽ ശ്രദ്ധ കേന്ദ്രീകരിക്കല്‍
### Repository Maintenance
- പഠനാർത്ഥികളും സംഭാവകരും ചേർന്ന് സജീവമായ സമൂഹം
- ആശ്രിതങ്ങളും ഉള്ളടക്കവും ക്രമാതീതമായി പുതുക്കപ്പെടുന്നു
- ഇഷ്യൂകളും ചര്‍ച്ചകളും മേൽനോട്ടം വഹിക്കുന്നു
- GitHub Actions വഴി പരിഭാഷാ അപ്ഡേറ്റുകൾ സ്വയം നടക്കുന്നു
- സജീവ പഠനരും സംഭാവനക്കാരും ഉള്ള സമൂഹം
- ആശ്രിതങ്ങളും ഉള്ളടക്കവും നിരന്തരമായ അപ്ഡേറ്റുകൾ
- പ്രശ്നങ്ങളും സംവാദങ്ങളും പരിരക്ഷകർ ശ്രദ്ധിക്കുന്നു
- വിവർത്തന അപ്ഡേറ്റുകൾ GitHub Actions വഴി ഓട്ടോമേറ്റഡ്
### Related Resources
- [Microsoft Learn മോഡ്യൂളുകൾ](https://docs.microsoft.com/learn/)
- [Student Hub റിസോഴ്‌സുകൾ](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) പഠനാർത്ഥികൾക്കായി ശുപാർശ ചെയ്യുന്നു
- മറ്റ് കോഴ്‌സുകൾ: ജനറേറ്റീവ് AI, ഡാറ്റാ സയൻസ്, ML, IoT പാഠ്യപദ്ധതികൾ ലഭ്യമാണ്
- [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) പഠനാർത്ഥികൾക്ക ശുപാർശ ചെയ്യുന്നു
- അധിക കോഴ്സുകൾ: Generative AI, Data Science, ML, IoT പാഠ്യക്രമങ്ങൾ ലഭ്യമാണ്
### Working with Specific Projects
തനത് പ്രോജക്റ്റുകൾക്ക് വിശദമായ നിർദ്ദേശങ്ങൾ ആവശ്യമെങ്കിൽ, താഴെ പറയുന്ന 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 ചാറ്റ് അസിസ്റ്റന്റ് പ്രോജക്റ്റ
സ്വതന്ത്രമായ പ്രോജക്ടുകൾക്കായുള്ള വിശദ നിർദ്ദേശങ്ങൾക്കായി 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 ചാറ്റ് അസിസ്റ്റന്റ് പ്രോജക്
### Monorepo Structure
പരമ്പരാഗത മോനോറെപ്പോ അല്ലെങ്കിലും, ഈ സംഭരണിയിൽ അനേകം സ്വതന്ത്ര പ്രോജക്റ്റുകൾ ചേർന്നു:
- ഓരോ പാഠവും സ്വയം പരിപാലിതമാണ്
- പ്രോജക്റ്റുകൾ ആശ്രിതങ്ങൾ പങ്ക് വെക്കില്ല
- മറ്റ് പ്രോജക്റ്റുകൾക്ക് ബാധിക്കാതെ വ്യക്തിപരമായി പ്രവർത്തിക്കാം
- മുഴുവൻ പാഠ്യപദ്ധതി അനുഭവത്തിനായി മുഴുവൻ റീപ്പോ ക്ലോൺ ചെയ്യുക
പരമ്പരാഗതമായ മോനോറീപോ അല്ലെന്നെങ്കിലും ഈ റീപ്പോസിറ്ററിയിൽ നിരവധി സ്വതന്ത്ര പ്രോജക്ടുകൾ ഉണ്ട്:
- ഓരോ ലെസനും സ്വതന്ത്രമായിട്ടുള്ളത്
- പ്രോജക്ടുകൾ ആശ്രിതങ്ങൾ പങ്കിടാറില്ല
- മറ്റൊരു പ്രോജക്ടിനെ ബാധിക്കാതെ വ്യക്തിഗത പ്രോജക്ടുകളിൽ ജോലി ചെയ്യാം
- മുഴുവൻ പാഠ്യക്രമ അനുഭവത്തിന് റീപോ മുഴുവനും ക്ലോൺ ചെയ്യുക
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**വിവിധാംശങ്ങൾ**:
ഡോക്യൂമെന്റ് 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 -->
Loading…
Cancel
Save