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

pull/1690/head
localizeflow[bot] 3 weeks ago
parent 16a9967bf4
commit a1de9c6d9b

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

@ -1,73 +1,73 @@
# AGENTS.md
## ಪ್ರೋಜೆಕ್ಟ್ ಅವಲೋಕನ
## Project Overview
ಇದು ಆರಂಭಿಕರಿಗೆ ವೆಬ್ ಅಭಿವೃದ್ಧಿ ಮೂಲತತ್ವಗಳನ್ನು ಕಲಿಸಲು ಶೈಕ್ಷಣಿಕ ಪಠ್ಯಕ್ರಮ ಸಂಗ್ರಹವಾಗಿದೆ. ಈ ಪಠ್ಯಕ್ರಮವು ಮೈಕ್ರೋಸಾಫ್ಟ್ ಕ್ಲೌಡ್ ಅಡ್ವೊಕೇಟ್‌ಗಳು ಅಭಿವೃದ್ಧಿ ಮಾಡಿರುವ ಸಂಪೂರ್ಣ 12-ವಾರಗಳ ಕೋರ್ಸ್ ಆಗಿದ್ದು, ಜಾವಾಸ್ಕ್ರಿಪ್ಟ್, CSS, ಮತ್ತು HTML ಅನ್ನು ಒಳಗೊಂಡ 24 ಕೈಗೆ ತಗಲುವ ಪಾಠಗಳನ್ನು ಹೊಂದಿದೆ.
ಇದು ಶುರುಮಾಡುವವರಿಗೆ ವೆಬ್ ಅಭಿವೃದ್ಧಿ ಮೂಲತತ್ವಗಳನ್ನು ಕಲಿಸಲು ಶಿಕ್ಷಣ ಕಾರ್ಯಕ್ರಮ ಶೇಖರಣಾಗಾರವಾಗಿದೆ. ಈ ಪಠ್ಯಕ್ರಮವು ಮೈಕ್ರೋಸಾಫ್ಟ್ ಕ್ಲೌಡ್ ಆ್ಯಡ್ವೊಕೇಟ್‌ಗಳು ಅಭಿವೃದ್ಧಿಪಡಿಸಿರುವ ಸಂಪೂರ್ಣ 12-ವಾರಗಳ ಕೋರ್ಸ್ ಆಗಿದ್ದು, ಜಾವಾಸ್ಕ್ರಿಪ್ಟ್, CSS ಮತ್ತು HTML ಕುರಿತು 24 ಹಸ್ತಚಾಲಿತ ಪಾಠಗಳನ್ನು ಒಳಗೊಂಡಿದೆ.
### ಮುಖ್ಯ ಘಟಕಗಳು
### Key Components
- **ೈಕ್ಷಣಿಕ ವಿಷಯ**: ಪ್ರಾಜೆಕ್ಟ್ ಆಧಾರಿತ ಘಟಕಗಳಲ್ಲಿ ಸಂಘಟಿತ 24 ರಚಿಸಲಾಗಿದೆ ಪಾಠಗಳು
- **ಪ್ರಾಯೋಗಿಕ ಪ್ರಾಜೆಕ್ಟ್‌ಗಳು**: ಟೆರರಿಯಂ, ಟೈಪಿಂಗ್ ಗೇಮ್, ಬ್ರೌಸರ್ ವಿಸ್ತರಣೆ, ಸ್ಪೇಸ್ ಗೇಮ್, ಬ್ಯಾಂಕಿಂಗ್ ಆಪ್, ಕೋಡ್ ಎಡಿಟರ್, ಮತ್ತು AI ಚಾಟ್ ಸಹಾಯಕ
- **ಸಂವಹನಾತ್ಮಕ ಪ್ರಶ್ನೆಗಳು**: 48 ಪ್ರಶ್ನೋತ್ತರಗಳು ಪ್ರತಿಯೋರ್ವದಲ್ಲಿ 3 ಪ್ರಶ್ನೆಗಳು (ಪೂರ್ವ/ಪೋಸ್ಟ್ ಪಾಠ ಮೌಲ್ಯಮಾಪನ)
- **ಬಹುಭಾಷಾ ಬೆಂಬಲ**: GitHub ಆಕ್ಶನ್‌ಗಳ ಮೂಲಕ 50+ ಭಾಷೆಗಳ ಸ್ವಯಂಚಾಲಿತ ಅನುವಾದಗಳು
- **ತಂತ್ರಜ್ಞಾನಗಳು**: HTML, CSS, ಜಾವಾಸ್ಕ್ರಿಪ್ಟ್, Vue.js 3, Vite, Node.js, Express, ಪೈಥಾನ್ (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 ಆಕ್ಶನ್‌ಗಳ(co-op-translator) ಮೂಲಕ ಅನುವಾದ ವ್ಯವಸ್ಥೆ
- ಡಾಕ್‌ಸಿಫೈ ಮೂಲಕ ಡಾಕ್ಯುಮೆಂಟೇಷನ್ ಸೇವೆ ಮತ್ತು 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
```
### ಪ್ರಶ್ನೋತ್ತರ ಆಪ್ ಸೆಟಪ್ (Vue 3 + Vite)
### Quiz App Setup (Vue 3 + Vite)
```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 ್ನು ಚಾಲನೆ ಮಾಡಿ
```
### ಬ್ಯಾಂಕ್ ಪ್ರಾಜೆಕ್ಟ್ API (Node.js + Express)
### Bank Project API (Node.js + Express)
```bash
cd 7-bank-project/api
npm install
npm start # API ಸರ್ವರ್ ಪ್ರಾರಂಭಿಸಿ
npm run lint # ESLint ರನ್ ಮಾಡಿ
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)
```bash
cd 9-chat-project/solution/backend/python
@ -76,207 +76,207 @@ pip install openai
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 # ನಿರ್ಮಾಣ ಯಶಸ್ವಿಯಾಗಿದ್ದೇ ಎಂದು ಪರಿಶೀಲಿಸಿ
```
### ಬ್ಯಾಂಕ್ API ಪರೀಕ್ಷೆ
### Bank API Testing
```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
- ಸ್ಪಷ್ಟ ಶೀರ್ಷಿಕೆ ಕ್ರಮ
- ಭಾಷಾ ವಿಶೇಷಣಗಳೊಂದಿಗೆ ಕೋಡ್ ಬ್ಲಾಕ್‌ಗಳು
- ಹೆಚ್ಚುವರಿ ಸಂಪನ್ಮೂಲಗಳಿಗೆ ಲಿಂಕುಗಳು
- `images/` ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ ಛಾಯಾಚಿತ್ರಗಳು ಮತ್ತು ಚಿತ್ರಗಳು
- ಪ್ರಾಪ್ಯತೆಯಿಗಾಗಿ ಚಿತ್ರಗಳಿಗೆ Alt ಪಠ್ಯ
- ಸ್ಪಷ್ಟ ಶೀರ್ಷಿಕಾ ಹಿರarkoನಾಮಿ
- ಭಾಷಾ ನಿರ್ದಿಷ್ಟತೆಳ್ಳದ ಕೋಡ್ ಬ್ಲಾಕ್‌ಗಳು
- ಹೆಚ್ಚಿನ ಸಂಪನ್ಮೂಲಗಳ ಲಿಂಕ್‌ಗಳು
- `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
### ಪ್ರಶ್ನೋತ್ತರ ಆಪ್ ನಿಯೋಜನೆ (Azure Static Web Apps)
### Quiz App Deployment (Azure Static Web Apps)
quiz-app ಅನ್ನು Azure Static Web Apps ನಿಯೋಜನೆಗಾಗಿ ಸಂರಚಿಸಲಾಗಿದೆ:
```bash
cd quiz-app
npm run build # dist/ ಫೋಲ್ಡರ್ ಅನ್ನು ಸೃಷ್ಟಿಸುತ್ತದೆ
# ಮುಖ್ಯ ಶಾಖೆಗೆ ಪುಷ್ ಮಾಡಿದಾಗ GitHub Actions ವರ್ಕ್‌ಫ್ಲೋ ಮೂಲಕ ಟ್ರಿಗರ್ ಮಾಡುತ್ತದೆ
npm run build # dist/ ಫೋಲ್ಡರ್ ಅನ್ನು ರಚಿಸುತ್ತದೆ
# main ಗೆ ಪುಶ್ ಮಾಡುವಾಗ GitHub Actions ವರ್ಕ್‌ಫ್ಲೋ ಮೂಲಕ ನಿಯೋಜಿಸುತ್ತದೆ
```
Azure Static Web Apps ಸಂರಚನೆ:
- **ಆಪ್ ಸ್ಥಾನ**: `/quiz-app`
- **ಫಲಿತಾಂಶ ಸ್ಥಳ**: `dist`
- **Workflow**: `.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`
### ಡಾಕ್ಯುಮೆಂಟೇಷನ್ PDF ತಯಾರಿಕೆ
### Documentation PDF Generation
```bash
npm install # docsify-to-pdf ಅನ್ನು ಹೊಂದಿಸಿ
npm run convert # ಡಾಕ್ಸ್ ನಿಂದ PDF ರಚಿಸಿ
npm install # docsify-to-pdf ಅನ್ನು ಸ್ಥಾಪಿಸಿ
npm run convert # docs ನಿಂದ PDF ರಚಿಸಿ
```
### ಡಾಕ್‌ಸಿಫೈ ಡಾಕ್ಯುಮೆಂಟೇಷನ್
### Docsify Documentation
```bash
npm install -g docsify-cli # ಡಾಕ್ಸಿಫೈಯನ್ನು ಜಾಗತಿಕವಾಗಿ ಸ್ಥಾಪಿಸಿ
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] ಟೆರರಿಯಂ ಪ್ರಾಜೆಕ್ಟಿನ ಟೈಪೋ ಸರಿಪಡಿಸಿ`
- `[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 ವಿವರಣೆಯಲ್ಲಿ ಉಲ್ಲೇಖಿಸಿ, ಅಗತ್ಯವಿದ್ದರೆ
- ಮೈಕ್ರೋಸಾಫ್ಟ್ 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 ಆಕ್ಶನ್‌ಗಳೊಂದಿಗೆ 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` ರನ್ಮಾಡಿ
- ಪೋರ್‌ಟ್ ಗೂಡಿನ ತಿರುವುಗಳ (default: 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-cli ಜಾಗತಿಕವಾಗಿ ಸ್ಥಾಪಿಸಿ: `npm install -g docsify-cli`
- ರೆಪೊ ರೂಟ್ ಡೈರೆಕ್ಟರಿಯಿಂದ ಚಾಲನೆ ಮಾಡಿ
- `docs/_sidebar.md` ಲಭ್ಯವಿದೆಯೇ ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ
### ಅಭಿವೃದ್ಧಿ ಪರಿಸರ ಸಲಹೆಗಳು
### Development Environment Tips
- HTML ಪ್ರಾಜೆಕ್ಟ್ಗಾಗಿ VS Code ಲೈವ್ ಸರ್ವರ್ ವಿಸ್ತರಣೆ ಉಪಯೋಗಿಸಿ
- ಸರ್ವ ವಿಶಿಷ್ಟ ಪ್ರಾರಂಭಿಕ ESLint ಮತ್ತು Prettier ವಿಸ್ತರಣೆಗಳನ್ನು ಸ್ಥಾಪಿಸಿ
- ಜಾವಾಸ್ಕ್ರಿಪ್ಟ್ ಡಿಬಗ್ಗಿಂಗ್‌ಗೆ ಬ್ರೌಸರ್ ಡೆವ್ ಟೂಲ್‌ಗಳು ಬಳಸಿ
- Vue ಪ್ರಾಜೆಕ್ಟ್ಗಾಗಿ Vue DevTools ಬ್ರೌಸರ್ ವಿಸ್ತರಣೆ ಇನ್ಸ್ಟಾಲ್ ಮಾಡಿ
- HTML ಪ್ರಾಜೆಕ್ಟ್ಗಾಗಿ VS Code ಲೈವ್ ಸರ್ವರ್ ವಿಸ್ತರಣೆ ಬಳಸಿ
- ಸಮಾನ ಸ್ವರೂಪಕ್ಕಾಗಿ ESLint ಮತ್ತು Prettier ವಿಸ್ತರಣೆಗಳನ್ನು ಸ್ಥಾಪಿಸಿ
- JavaScript ದೋಷ ಪರೀಕ್ಷೆಗೆ ಬ್ರೌಸರ್ ಡೆವ್ ಟೂಲ್ಸ್ ಉಪಯೋಗಿಸಿ
- 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 ಮಾದರಿಗಳ ಪ್ರವೇಶ
### GitHub Models Access
- GitHub ಮಾದರಿಗಳಿಗಾಗಿ ವೈಯಕ್ತಿಕ ಪ್ರವೇಶ ಟೋಕನ್‌ಗಳು (PAT) ಅಗತ್ಯ
- ಟೋಕನ್‌ಗಳನ್ನು ಪರಿಸರ ವೇರಿಯಬೆಲ್ ಗಳಾಗಿ ಸಂಗ್ರಹಿಸಿ
- ಟೋಕನ್ ಅಥವಾ ಪ್ರಮಾಣಪತ್ರಗಳನ್ನು ಎಂದಿಗೂ ಸಂಗ್ರಹಕ್ಕೆ ಹಾಕಬೇಡಿ
- GitHub ಮಾದರಿಗಳಿಗೆ ಪರ್ಸನಲ್ ಆಕ್ಸೆಸ್ ಟೋಕನ್‌ಗಳು (PAT) ಅಗತ್ಯವಿದೆ
- ಟೋಕನ್‌ಗಳನ್ನು ಪರಿಸರ ಚರಗಳಲ್ಲಿ ಸಂಗ್ರಹಿಸಿ
- ಟೋಕನ್ ಅಥವಾ ಕ್ರೆಡೆಂಶಿಯಲ್ಗಳು ಎಂದಿಗೂ ಕಮಿಟ್ ಮಾಡಬೇಡಿ
## ಹೆಚ್ಚುವರಿ ಟಿಪ್ಪಣಿಗಳು
## Additional Notes
### ಗುರಿ ಪ್ರೇಕ್ಷಕರು
### Target Audience
- ವೆಬ್ ಅಭಿವೃದ್ಧಿ ಹೊಸಬರಿಗೂ
- ವಿದ್ಯಾರ್ಥಿಗಳು ಮತ್ತು ಸ್ವ-ಕಲಿಯುವವರು
- ತರಗತಿಯಲ್ಲಿ ಪಠ್ಯಕ್ರಮ ಬಳಸಿ ಶಿಕ್ಷಕರು
- ವಿಷಯವು ಪ್ರವೇಶಕಾರಿ ಮತ್ತು ಹಂತ ಹಂತವಾಗಿ ಕೌಶಲ್ಯಗಳನ್ನು ಕಟ್ಟಲು ವಿನ್ಯಾಸಗೊಳಿಸಲಾಗಿದೆ
- ಸಂಪೂರ್ಣ ಆರಂಭಸಿದ, ವೆಬ್ ಅಭಿವೃದ್ಧಿಗೆ ಹೊಸವರು
- ವಿದ್ಯಾರ್ಥಿಗಳು ಮತ್ತು ಸ್ವಯಂ ಕಲಿಯುವವರು
- ತರಗತಿಯಲ್ಲಿ ಪಠ್ಯಕ್ರಮ ಬಳಸಿ ಶಿಕ್ಷಕರು
- ವಿಷಯವು ಪ್ರಾಪ್ಯತೆ ಮತ್ತು ಹಂತಬದ್ಧ ಕೌಶಲ್ಯ ನಿರ್ಮಾಣಕ್ಕೆ ವಿನ್ಯಾಸಗೊಳಿಸಲಾಗಿದೆ
### ಶೈಕ್ಷಣಿಕ ತತ್ವಶಾಸ್ತ್ರ
### Educational Philosophy
- ಪ್ರಾಜೆಕ್ಟ್ ಆಧಾರಿತ ಕಲಿಕೆ ಕ್ರಮ
- ನಿಯಮಿತ ಜ್ಞಾನ ಪರೀಕ್ಷೆಗಳು (ಪ್ರಶ್ನೋತ್ತರಗಳು)
- ಕೈಗೆ ತಗಲುವ ಕೋಡಿಂಗ್ ಅಭ್ಯಾಸಗಳು
- ನಿಖರ ಜಗತ್ತಿನ ಅನ್ವಯ ನ್ಯಾಯоматಗಳು
- ಫ್ರೇಮ್ವರ್ಕ್ಗಳಿಗಿಂತ ಮೊದಲು ಮೂಲಭೂತಗಳನ್ನು ಗಮನಿಸು
- ಪ್ರಾಜೆಕ್ಟ್ ಆಧಾರಿತ ಕಲಿಕೆ ವಿಧಾನ
- ನಿಯಮಿತ ಜ್ಞಾನ ಪರಿಶೀಲನೆಗಳು (ಕ್ವಿಜ್‌ಗಳು)
- ಹಸ್ತಚಾಲಿತ ಕೋಡಿಂಗ್ ವ್ಯಾಯಾಮಗಳು
- ವಾಸ್ತವಿಕ ಜಗತ್ತಿನ ಅನ್ವಯಿಸುವಿಕೆ ಉದಾಹರಣೆಗಳು
- ಫ್ರೇಮ್ವರ್ಕ್‌ಗಳ ಹಿಂದೆ ಮೂಲತತ್ವಪ್ರಜ್ಞೆ ಮೇಲೆ ಗಮನ
### ಸಂಗ್ರಹ ನಿರ್ವಹಣೆ
### Repository Maintenance
- ಕಲಿಕೆಯಿಂದ ಮತ್ತು ಕೊಡುಗೆದಾರರ ಚಟುವಟಿಕೆ ಸಮುದಾಯ
- ಅವಲಂಬನೆಗಳು ಮತ್ತು ವಿಷಯದ ನಿಯಮಿತ ನವೀಕರಣಗಳು
- ನಿರ್ವಹಕರಿಂದ ಸಮಸ್ಯೆಗಳು ಮತ್ತು ಚರ್ಚೆಗಳು ಗಮನದಲ್ಲಿರಲಿ
- ಅನುವಾದ ನವೀಕರಣಗಳು GitHub ಆಕ್ಶನ್ಗಳ ಮೂಲಕ ಸ್ವಯಂಚಾಲಿತ
- ಕಲಿಕೆಯಲ್ಲಿ ನಿರತ ಸದಸ್ಯರ ಸಮುದಾಯ
- ಅವಲಂಬನೆ ಮತ್ತು ವಿಷಯಗಳ ನಿಯಮಿತ ನವೀಕರಣ
- ನಿರ್ವಹಕರು ಭದ್ರಪಡೆದುಕೊಂಡ ಪ್ರಶ್ನೆಗಳು ಮತ್ತು ಚರ್ಚೆಗಳು
- 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, ಡೇಟಾ ಸೈನ್ಸ್, 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) ಕಲಿಯುವವರಿಗೆ ಶಿಫಾರಸು
- ಹೆಚ್ಚುವರಿ ಕೋರ್ಸುಗಳು: ಜನರೇಟಿವ್ AI, ಡೇಟಾ ಸೈನ್ಸ್, ಎಂಎಲ್, ಐಒಟಿ ಪಠ್ಯಕ್ರಮಗಳು ಲಭ್ಯ
### ನಿರ್ದಿಷ್ಟ ಪ್ರಾಜೆಕ್ಟ್‌ಗಳೊಂದಿಗೆ ಕೆಲಸ
### 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) ಬಳಸಿ ಅನುವಾದಿಸಲಾಗಿದೆ. ನಾವು ಸತ್ಯತೆಗಾಗಿ ಪ್ರಯತ್ನಿಸುತ್ತಿದ್ದರೂ, ಸ್ವಯಂಚಾಲಿತ ಅನುವಾದಗಳಲ್ಲಿ ದೋಷಗಳು ಅಥವಾ ಅಸಮತೋಲನಗಳು ಇರಬಹುದು ಎಂಬುದು ಗಮನಕ್ಕೆ ತಗೆದುಕೊಳ್ಳಿ. ಮೂಲ ಭಾಷೆಯ ಮೂಲ ಡಾಕ್ಯುಮೆಂಟ್ ಅನ್ನು ಅಧಿಕಾರಪ್ರದ ಮೂಲವೆಂದು ಪರಿಗಣಿಸಬೇಕು. ಪ್ರಮುಖ ಮಾಹಿತಿಗಾಗಿ, ವೃತ್ತಿಪರ ಮಾನವ ಅನುವಾದವನ್ನು ಶಿಫಾರಸು ಮಾಡಲಾಗುತ್ತದೆ. ಈ ಅನುವಾದ ಬಳಕೆದಿಂದ ಉಂಟಾಗಬಹುದಾದ ಯಾವುದೇ непuಜ್ಞಾತತೆ ಅಥವಾ ತಪ್ಪು ಹಕ್ಕುಗಳಿಗಾಗಿ ನಾವು ಜವಾಬ್ದಾರಿಯಾಗುವುದಿಲ್ಲ.
**ವಿಮೋಚನೆ**:
ದಸ್ತಾವೇಜನ್ನು AI অনುವಾದ ಸೌಲಭ್ಯ [Co-op Translator](https://github.com/Azure/co-op-translator) ಬಳಸಿ ಅನುವದಿಸಲಾಗಿದೆ. ನಾವು ಶುದ್ಧತೆಗೆ ಪ್ರಯತ್ನ ಮಾಡುವುದಾದರೂ, ಸ್ವಯಂಚಾಲಿತ ಅನುವಾದಗಳಲ್ಲಿ ತಪ್ಪುಗಳು ಅಥವಾ ಅಸತ್ಯತೆಗಳಿರಬಹುದು ಎಂದು ದಯವಿಟ್ಟು ಗಮನಿಸಿ. ಮೂಲ ಭಾಷೆಯ ಮೂಲ ದಸ್ತಾವೇಜನ್ನು ಅಧಿಕೃತ ಮೂಲವೆಂದು ಪರಿಗಣಿಸಬೇಕು. ಮಹತ್ವದ ಮಾಹಿತಿಗಾಗಿ, ವೃತ್ತಿಪರ ಮಾನವ ಅನುವಾದವನ್ನು ಶಿಫಾರಸು ಮಾಡಲಾಗುತ್ತದೆ. ಈ ಅನುವಾದ ಬಳಕೆಯಿಂದಾಗಿ ಹುಟ್ಟಿದ ಯಾವುದೇ ಅರ್ಥಬೇಧ ಅಥವಾ ತಪ್ಪಾದ ಅರ್ಥೈಸಿಕೆಗೆ ನಾವು ಜವಾಬ್ದಾರಿಯಲ್ಲದಿದ್ದೇವೆ.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->

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

@ -2,27 +2,27 @@
## Project Overview
ഇത് വെബ് ഡെവലപ്പ്മെന്റ് അടിസ്ഥാനങ്ങള്‍ തുടങ്ങുന്നവര്‍ക്ക് പഠിപ്പിക്കാന്‍ ഉള്ള ഒരു വിദ്യാഭ്യാസ കോഴ്‌സ് റിപോസിറ്ററിയാണ്. ഇത് മൈക്രോസോഫ്റ്റ് ക്ലൗഡ് അഡ്വക്കേറ്റുകള്‍ വികസിപ്പിച്ച 12 ആഴ്ച കാലയളവില്‍ 24 പ്രായോഗിക ലെസ്സനുകള്‍ അടങ്ങിയ സമഗ്ര കോഴ്‌സാണ്, ജാവാസ്ക്രിപ്റ്റ്, CSS, HTML എന്നിവയെക്കുറിച്ചാണ്.
ഇത് തുടങ്ങിയവർക്കായി വെബ് ഡെവലപ്പ്മെന്റ് അടിസ്ഥാനങ്ങൾ പഠിപ്പിക്കുന്ന ഒരു വിദ്യാഭ്യാസ പാഠ്യപദ്ധതി സംഭരണിയാണിത്. Microsoft Cloud Advocates വികസിപ്പിച്ച സ്വരൂപായി 12 ആഴ്ച നീളുന്ന സമഗ്ര കോഴ്‌സ് ആണ്, ജാവാസ്ക്രിപ്റ്റ്, CSS, HTML എന്നിവ ഉൾപ്പെടുത്തി 24 ഹാൻഡ്സ്-ഓൺ പാഠങ്ങൾ ഇതിൽ ഉൾപ്പെടുത്തിയിട്ടുണ്ട്.
### Key Components
- **വിദ്യാഭ്യാസ ഉള്ളടക്കം**: പ്രോജക്ട് അടിസ്ഥാനമാക്കിയുള്ള 24 ഘടിപ്പിച്ച ലെസ്സനുകള്‍
- **പ്രായോഗിക പ്രോജക്ടുകള്‍**: ടെറാറിയം, ടൈപ്പിംഗ് ഗെയിം, ബ്രൗസര്‍ എക്‌സ്റ്റന്‍ഷന്, സ്പേസ് ഗെയിം, ബാങ്കിംഗ് അപ്, കോഡ് എഡിറ്റര്‍, AI ചാറ്റ് അസിസ്റ്റന്റ്
- **ഇന്ററാക്ടീവ് ക്വിസ്**: 48 ക്വിസുകള്‍ 3 ചോദ്യങ്ങളോടു കൂടി (പ്രീ/പോസ്റ്റ് ലെസ്സന്‍ പരിശോധനകള്‍)
- **ബഹുഭാഷ പിന്തുണ**: 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
@ -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)
@ -46,7 +46,7 @@ npm run lint # ESLint നടത്തുക
```bash
cd 7-bank-project/api
npm install
npm start # API സർവർ ആരംഭിക്കുക
npm start # API സർവർ ആരംഭിക്കുക
npm run lint # ESLint പ്രവർത്തിപ്പിക്കുക
npm run format # Prettier ഉപയോഗിച്ച് ഫോർമാറ്റ് ചെയ്യുക
```
@ -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 അക്കൗണ്ടിലേക്ക്
2. **ഫോര്‍ക്ക് ക്ലോണ്‍ ചെയ്യുക** നികുതി ആയി
3. **പുതിയ ബ്രാഞ്ച് സൃഷ്ടിക്കുക** നിങ്ങളുടെ മാറ്റങ്ങള്‍ക്ക്
4. ലെസ്സനുകളിലെ ഉള്ളടക്കം അല്ലെങ്കില്‍ കോഡ് ഉദാഹരണങ്ങള്‍ മാറ്റുക
5. ബന്ധപ്പെട്ട പ്രോജക്ട് ഡയറക്ടറികളിൽ കോഡ് പരിശോധിക്കുക
6. സംഭാവനാ മാർഗ്ഗനിര്‍ദേശങ്ങള്‍ പാലിച്ച് പുള്ള് റിക്വസ്റ്റ് സമര്‍പ്പിക്കുക
1. **റിപ്പോസിറ്ററി നിങ്ങളുടെ GitHub അക്കൗണ്ടിലേക്ക് Fork ചെയ്യുക**
2. **നിങ്ങളുടെ Fork ലോക്കലി Clone ചെയ്യുക**
3. **മാറുന്നതിനു പുതിയ ബ്രാഞ്ച് സൃഷ്ടിക്കുക**
4. പാഠ ഉള്ളടക്കം അല്ലെങ്കിൽ കോഡ് മാതൃകകളിൽ മാറ്റങ്ങൾ വരുത്തുക
5. ബന്ധപ്പെട്ട പ്രോജക്റ്റ് ഡയറക്ടറികളിൽ കോഡ് മാറ്റങ്ങൾ പരീക്ഷിക്കുക
6. സംഭാവന മാർഗനിർദ്ദേശങ്ങൾ പാലിച്ച് പുൾ റിക്വസ്റ്റ് നൽകുക
### For Learners
1. റിപോസിറ്ററി ഫോര്‍ക്ക് ചെയ്യുക അല്ലെങ്കില്‍ ക്ലോണ്‍ ചെയ്യുക
2. ലെസ്സന്‍ ഡയറക്ടറികളില്‍ ക്രമաբար എത്തുക
3. ഓരോ ലെസ്സനും README ഫയലുകൾ വായിക്കുക
4. പ്രീ-ലെസ്സന്‍ ക്വിസുകള്‍ https://ff-quizzes.netlify.app/web/ ൽ പൂരിപ്പിക്കുക
5. ലെസ്സന്‍ ഫോളഡറുകളില്‍ കോഡ് ഉദാഹരണങ്ങളില്‍ ജോലി ചെയ്യുക
6. അസൈന്‍മെന്റുകളും ചലഞ്ചുകളും പൂർത്തിയാക്കുക
7. പോസ്റ്റ്-ലെസ്സന്‍ ക്വിസുകള്‍ പിന്തുടരുക
1. റിപ്പോസിറ്ററി Fork ആക്കുകയോ Clone ചെയ്യുകയോ ചെയ്യുക
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 ലൈവ് സെര്‍വര്‍ എക്സ്റ്റന്‍ഷന്‍ ഉപയോഗിക്കുക
- **API Projects**: പ്രാദേശിക API ഡയറക്ടറികളില്‍ `npm start` റണ്‍ ചെയ്യുക
- **ഡോക്യുമെന്റേഷൻ**: റൂട്ടിൽ `docsify serve` പ്രവർത്തിപ്പിക്കുക (പോർട്ട് 3000)
- **Quiz App**: quiz-app ഡയറക്ടറിയി`npm run dev` ക്ലിക്ക് ചെയ്യുക
- **Projects**: HTML പ്രോജക്റ്റുകൾക്കായി VS Code Live Server എക്സ്റ്റൻഷൻ ഉപയോഗിക്കുക
- **API Projects**: ബന്ധപ്പെട്ട API ഡയറക്ടറികളിൽ `npm start` പ്രവർത്തിപ്പിക്കുക
## Testing Instructions
@ -110,173 +110,173 @@ python api.py
```bash
cd quiz-app
npm run lint # കോഡ് ശൈലി പ്രശ്നങ്ങൾ പരിശോധിക്കുക
npm run build # ബിൽഡ് വിജയിക്കുന്നത് സ്ഥിരീകരിക്കുക
npm run lint # കോഡ് സ്റ്റൈൽ പ്രശ്നങ്ങൾ പരിശോധിക്കുക
npm run build # ബിൽഡ് വിജയകരമാണെന്ന് ഉറപ്പാക്കുക
```
### Bank API Testing
```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 ക്രമീകരണങ്ങള്‍ പാലിക്കുക
- വിദ്യാഭ്യാസ സൗഹൃദമായ വേരിയബിൾ ആൻഡ് ഫംഗ്ഷൻ നാമങ്ങൾ ഉപയോഗിക്കുക
- പഠിക്കുന്നവര്‍ക്കായി ആശയങ്ങള്‍ വിശദീകരിക്കുന്ന കുറിപ്പുകള്‍ ചേർക്കുക
- പ്രീട്ടിയറിലൂടെ ഫോർമാറ്റിംഗ് ചെയ്യുക (ആവശ്യപെട്ട സ്ഥലത്ത്)
- ആധുനിക ES6+ സിന്റാക്സ് ഉപയോഗിക്കുക
- പ്രോജക്റ്റുകളിൽ നൽകിയ സ്റ്റാൻഡേർഡ് ESLint കോൺഫിഗറേഷനുകൾ പിന്തുടരുക
- വിദ്യാഭ്യാസ പരിസരത്തിൽ മനസ്സിലാകുന്നതിന് പ്രാധാന്യമുള്ള മൂല്യനാമങ്ങൾ, ഫംഗ്ഷൻ പേരുകൾ ഉപയോഗിക്കുക
- പഠനാർത്ഥികൾക്കായി ആശയങ്ങൾ വിശദമാക്കുന്ന കമന്റുകൾ ചേർക്കുക
- Prettier ഉപയോഗിച്ച് ഫോർമാറ്റ് ചെയ്യുക (കോൺഫിഗർ ചെയ്യപ്പെട്ടിടത്ത്)
### HTML/CSS
- സമാന്റിക് HTML5 ഘടകങ്ങൾ
- റസ്പോൺസീവ് ഡിസൈൻ സിദ്ധാന്തങ്ങൾ
- ബോധഗമ്യമായ ക്ലാസ് പേര് നിർദ്ദേശങ്ങൾ
- CSS സാങ്കേതികവിദ്യകള്‍ പഠനാർത്ഥം വിശദീകരിക്കുന്ന കുറിപ്പുകള്‍
- സമാന്റിക് HTML5 ഘടകങ്ങൾ
- പ്രതികരണശീലമുള്ള (responsive) ഡിസൈൻ സിദ്ധാന്തങ്ങൾ
- വ്യക്തമായ ക്ലാസ് നാമകരണം
- 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 വർക്ക്‌ഫ്ലോ വഴി main-ലേക്ക് പുഷ് ചെയ്തപ്പോൾ വിന്യാസപ്പെടുത്തുന്നു
npm run build # dist/ ഫോഡർ സൃഷ്ടിക്കുന്നു
# പ്രധാന ബ്രാഞ്ചിലേക്ക് പുഷ് ചെയ്തപ്പോൾ GitHub Actions വർക്ക്‌ഫ്ലോ വഴി വിന്യസിക്കുന്നു
```
Azure Static Web Apps ക്രമീകരണം:
- **ആപ്പ് സ്ഥലം**: `/quiz-app`
- **ഔട്ട്‌പുട്ട് സ്ഥലം**: `dist`
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 # ഡോക്സ്ഫൈ നിന്നും പി.ഡി.എഫ്. സൃഷ്ടിക്കുക
npm run convert # ഡോക്‌സ് ആണ് നിന്ന് PDF എടുക്കുക
```
### Docsify Documentation
```bash
npm install -g docsify-cli # Docsifyയെ ആഗോളതലത്തിൽ ഇൻസ്റ്റാൾ ചെയ്യുക
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] Terrarium പ്രോജക്ടിലെ തെറ്റായ എഴുത്ത് ശരിയാക്കുക`
- `[Translation] ലെസ്സന്‍ 5-ന് സ്‌പാനിഷ് പരിഭാഷ ചേർക്കുക`
മാറ്റത്തിന്റെ പ്രദേശം വ്യക്തം ചെയ്യുന്ന സ്ഥിരീകരണശീർഷകങ്ങൾ ഉപയോഗിക്കുക:
- `[Quiz-app] പാഠം X-നായി പുതിയ ക്വിസ് ചേർക്കുക`
- `[Lesson-3] ടെറേറിയം പ്രോജക്റ്റിലെ ടൈപ്പോ തിരുത്തുക`
- `[Translation] പാഠം 5-നുള്ള സ്പാനിഷ് പരിഭാഷ ചേർക്കുക`
- `[Docs] സെറ്റപ്പ് നിർദ്ദേശങ്ങൾ അപ്ഡേറ്റ് ചെയ്യുക`
### 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
- മൈക്രോസോഫ്റ്റ് CLA അംഗീകാരം (ആദ്യ PR автоматഡ് പരിശോധണം)
- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) പാലിക്കുക
- വിശദമായ മാർഗ്ഗനിർദേശങ്ങൾക്ക് [CONTRIBUTING.md](./CONTRIBUTING.md) കാണുക
- PR വിവരണത്തില്‍ പ്രശ്ന നമ്പറുകൾ പരാമർശിക്കുക (ബാധകമെങ്കിൽ)
- Microsoft CLA (പ്രഥമ PR-ൽ സ്വയം പരിശോധന) അംഗീകരിക്കുക
- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) അനുസരിക്കുക
- വിശദമായ മാർഗനിർദ്ദേശങ്ങൾക്കായി [CONTRIBUTING.md](./CONTRIBUTING.md) കാണുക
- പ്രാസക്തമായെങ്കിൽ PR വിവരണത്തിൽ issue നമ്പറുകൾ ഉൾപ്പെടുത്തുക
### 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` വഴി ഇൻസ്റ്റാൾ ചെയ്തുവെന്ന് ഉറപ്പാക്കുക
**ബ്രൗസർ എക്‌സ്റ്റൻഷൻ ലോഡ് ചെയ്യുന്നില്ല**:
- manifest.json ശരിയായി ഫോർമാറ്റ് ചെയ്തിട്ടുണ്ടോ എന്ന് പരിശോധിക്കുക
- ബ്രൗസർ കോൺസോൾ എററുകൾ പരിശോധിക്കുക
- ബ്രൗസര്‍ പ്രത്യേക എക്‌സ്റ്റന്‍ഷന്‍ ഇൻസ്റ്റാളേഷൻ നിർദേശങ്ങൾ പിന്തുടരുക
**Browser extension ലോഡ് ആവുന്നില്ല**:
- manifest.json ശരിയായി രൂപപ്പെടുത്തിയിട്ടുണ്ടോ എന്ന് പരിശോധിക്കുക
- ബ്രൗസർ കോൺസോളിൽ പിശക് സന്ദേശങ്ങൾ കാണുക
- ബ്രൗസർ വ്യത്യസ്ത ഇങ്ങനെ സ്ഥാപിക്കൽ നിർദ്ദേശങ്ങൾ പാലിക്കുക
**Python ചാറ്റ് പ്രോജക്ട് പ്രശ്നങ്ങള്‍**:
- OpenAI പാക്കേജ് ഇൻസ്റ്റാള്‍ ചെയ്തിട്ടുണ്ടോ: `pip install openai`
- GITHUB_TOKEN പരിസ്ഥിതി വ്യത്യാസം സജ്ജമാക്കിയിട്ടുണ്ടോ
- GitHub മോഡലുകൾക്ക് പ്രവേശന അവകാശം പരിശോധിക്കുക
**Python ചാറ്റ് പ്രോജക്റ്റ് പ്രശ്നങ്ങൾ**:
- OpenAI പാക്കേജ് ഇൻസ്റ്റാ ചെയ്തിട്ടുണ്ടോ: `pip install openai`
- GITHUB_TOKEN എൻവയോൺമെന്റ് വെറിയബിള്‍ ക്രമീകരിച്ചതാണെന്ന് പരിശോധിക്കുക
- GitHub Models ആക്‌സസ് അനുമതികൾ ശരിയാണെന്ന് ഉറപ്പാക്കുക
**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 ലൈവ് സെർവർ എക്സ്റ്റൻഷൻ ഉപയോഗിക്കുക
- തുടർച്ചയായ ഫോർമാറ്റിംഗിനായി ESLint, Prettier എക്സ്റ്റൻഷനുകൾ ഇൻസ്റ്റാൾ ചെയ്യുക
- ജാവാസ്ക്രിപ്റ്റ് ഡീബഗിന് ബ്രൗസർ DevTools ഉപയോഗിക്കുക
- Vue പ്രോജക്ടുകളില്‍ Vue DevTools ബ്രൗസര്‍ എക്സ്റ്റന്‍ഷന്‍ ഇൻസ്റ്റാൾ ചെയ്യുക
- HTML പ്രോജക്റ്റുകളിൽ VS Code Live Server എക്സ്റ്റൻഷൻ ഉപയോഗിക്കുക
- സ്ഥിരത പാലിക്കാനായി ESLint, Prettier എക്സ്റ്റൻഷനുകൾ ഇൻസ്റ്റാൾ ചെയ്യുക
- ജാവാസ്ക്രിപ്റ്റ് ഡിബഗ് ചെയ്യുന്നതിനായി ബ്രൗസർ DevTools ഉപയോഗിക്കുക
- Vue പ്രോജക്റ്റുകൾക്കായി Vue DevTools ബ്രൗസർ എക്സ്റ്റൻഷൻ ഇൻസ്റ്റാൾ ചെയ്യുക
### Performance Considerations
- 50ല്‍പ്പരം ഭാഷകളിലുള്ള പരിഭാഷയോടെ ഗ്രന്ഥശേഖരം വലുത് ആകും
- ഉള്ളടക്കത്തിൽ മാത്രം ജോലിചെയ്യുന്നെങ്കിൽ ഷാലോ ക്ലോണ്‍ ഉപയോഗിക്കുക: `git clone --depth 1`
- ഇംഗ്ലീഷ് ഉള്ളടക്കത്തിൽ ജോലി ചെയ്യുമ്പോൾ പരിഭാഷ ഫയലുകൾ തിരച്ചിൽ ഒഴിവാക്കുക
- ആദ്യത്തെ റൺ സമയത്ത് ബിൽഡ് പ്രക്രിയകൾ മന്ദഗതിയിൽ (npm install, Vite build)
- 50-ലധികം ഭാഷകളിലുള്ള വലിയ പരിഭാഷാ ഫയൽ എണ്ണം ഗിറ്റിന്റെ മുഴുവൻ ക്ലോണുകൾ വലിയതാക്കും
- ഉള്ളടക്കത്തിൽ മാത്രം പ്രവർത്തിക്കാനായി ശാലോ ക്ലോൺ ചെയ്യുക: `git clone --depth 1`
- ഇംഗ്ലീഷ് ഉള്ളടക്കത്തിൽ ജോലി നടത്തുമ്പോൾ പരിഭാഷകൾ തിരച്ചില്ലിൽ നിന്ന് ഒഴിവാക്കുക
- npm ഇൻസ്റ്റാൾ, Vite ബിൽഡ് തുടങ്ങിയ ആദ്യ പ്രവർത്തനങ്ങൾ ഇത് സ്ലോ ആയി ആകാൻ സാധ്യത
## 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 മോഡലുകൾക്ക് വ്യക്തിഗത ആക്സസ് ടോക്കണുകൾ (PAT) ആവശ്യമാണ്
- ടോക്കണുകൾ പരിസ്ഥിതി മാറിൽ സൂക്ഷിക്കുക
- ടോക്കണുകൾ അല്ലാതെ മറ്റേതൊന്നും കമ്മിറ്റ് ചെയ്യരുത്
- GitHub മോഡലുകൾക്കായി Personal Access Tokens (PAT) ആവശ്യമാണ്
- ടോകണുകൾ എൻവയോൺമെന്റ് വെറിയബിൾസായി മാത്രമേ സൂക്ഷിക്കാവൂ
- ടോകണുകളും ക്രെഡൻഷ്യലുകളും ഒരിക്കലും കമ്മിറ്റ് ചെയ്യരുത്
## Additional Notes
### Target Audience
- വെബ് ഡെവലപ്പ്മെന്റിൽ പൂർണ്ണമായി പുതു പ്രവേശകരും
- വിദ്യാർഥികളും സ്വയം പഠിക്കുന്നവരും
- ക്ലാസ് മുറികളിൽ കോഴ്സ് ഉപയോഗിക്കുന്ന അദ്ധ്യാപകരും
- ഉള്ളടക്കം ആക്സസിബിലിറ്റിക്ക് അനുയോജ്യമായുമില്ലാതെ ലൈവിലായി ക_DEL buiil_columns_ udderizing সহজയ
- വെബ് ഡെവലപ്പ്മെന്റിൽ പൂർത്തിയായ തുടക്കക്കാർ
- വിദ്യാർത്ഥികൾ, സ്വയം പഠിക്കുന്നവർ
- ക്ലാസിൽ പാഠമുറിവുകൾ ഉപയോഗിക്കുന്ന അധ്യപകർ
- ആക്‌സസ്സിബിലിറ്റിക്കും കൃത്യമായ കഴിവുയർത്തലിനും രൂപകൽപ്പന ചെയ്‌ത ഉള്ളടക്ക
### 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, ഡേറ്റാ സയൻസ്, ML, IoT യുക്തി ക്രമീകരണങ്ങൾ ലഭ്യമാണ്
- [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 പാഠ്യപദ്ധതികൾ ലഭ്യമാണ്
### 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 -->
**വ്യത്യാസക്കുറിപ്പ്**:
दस्तാവेज़ [Co-op Translator](https://github.com/Azure/co-op-translator) എന്ന AI വിവർത്തന സേവനം ഉപയോഗിച്ചാണ് പരിഭാഷപ്പെടുത്തിയിരിക്കുന്നത്. ഞങ്ങൾ കൃത്യതയിലേക്ക് ശ്രമിക്കുന്നുവെങ്കിലും, യാന്ത്രിക വിവർത്തനങ്ങളിൽ പിഴവുകളും അസാധുതകളും ഉണ്ടാകാമെന്ന് മനസ്സിലാക്കി ഇടപെടുക. મૂળ ദസ്താവേജിലെ സ്വഭാവഭാഷ തന്നെ അതിന്റെ അവകാശപ്പെട്ട ഉറവിടമാണ്. നിർണായകമായ വിവരങ്ങൾക്ക്, പ്രൊഫഷണൽ മനുഷ്യ വിവർത്തനം ശിപാർശ ചെയ്യുന്നു. ഈ വിവർത്തനം ഉപയോഗിക്കുന്നതിൽ നിന്നുള്ള സ്ത്രീഭ്രംശങ്ങൾക്കോ തെറ്റായ വ്യാഖ്യാനങ്ങൾക്കോ ഞങ്ങൾ ഉത്തരവാദിത്വം വഹിക്കുന്നില്ല.
**വിവിധാംശങ്ങൾ**:
ഡോക്യൂമെന്റ് AI വിവർത്തന സേവനം [Co-op Translator](https://github.com/Azure/co-op-translator) ഉപയോഗിച്ച് വിവർത്തനം ചെയ്തതാണ്. നാം എത്രത്തോളം കൃത്യതയ്ക്ക് ശ്രമിച്ചാലും, സ്വയംഭൃതമായ വിവർത്തനങ്ങളിൽ പിശകുകളും തെറ്റുകൾ ഉണ്ടാകാനുള്ള സാധ്യതയുണ്ട് എന്ന് ദയവായി ശ്രദ്ധിക്കുക. സ്വതന്ത്ര ഭാഷയിൽ ഉള്ള യഥാർത്ഥ ഡോക്യൂമെന്റാണ് പ്രാമാണികമായ ഉറവിടമെന്ന് കണക്കാക്കണേ. നിർണ്ണായകമായ വിവരങ്ങൾക്കായി പ്രൊഫഷണൽ മനുഷ്യ വിവർത്തനം ശുപാർശ ചെയ്യപ്പെടുന്നു. ഈ വിവർത്തനത്തിന്റെ ഉപയോഗം മൂലം ഉണ്ടായേക്കാവുന്ന യാതൊരു തെറ്റായ അർത്ഥങ്ങളുടെ ഉത്തരവാദിത്വവും ഞങ്ങൾ ഏറ്റെടുക്കുന്നില്ല.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->
Loading…
Cancel
Save