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

pull/1774/head
localizeflow[bot] 3 months ago
parent 9346676db1
commit 9809c0af45

@ -1,7 +1,7 @@
{
"1-getting-started-lessons/1-intro-to-programming-languages/README.md": {
"original_hash": "bec5e35642176d9e483552bfc82996d8",
"translation_date": "2026-03-06T14:20:58+00:00",
"original_hash": "d5eeb6e975b5864d8da52d4a41941f8d",
"translation_date": "2026-03-27T21:07:09+00:00",
"source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md",
"language_code": "kn"
},
@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-03-06T14:25:52+00:00",
"translation_date": "2026-03-27T21:12:08+00:00",
"source_file": "AGENTS.md",
"language_code": "kn"
},

@ -1,57 +1,57 @@
# AGENTS.md
## ಪ್ರಾಜೆಕ್ಟ್ ಅವಲೋಕನ
## Project Overview
ಇದು ಪ್ರಾರಂಭಿಕರಿಗಾಗಿ ವೆಬ್ ಅಭಿವೃದ್ಧಿಯ ಮೂಲತತ್ತ್ವಗಳನ್ನು ಕಲಿಸುವ ಶಿಕ್ಷಣ ಕಾರ್ಯಕ್ರಮದ ರೆಪೊಸಿಟರಿ ಆಗಿದೆ. ಈ ಕಾರ್ಯಕ್ರಮವು ಮೈಕ್ರೋಸಾಫ್ಟ್ ಕ್ಲೌಡ್ ಅಡ್ವೊಕೇಟ್ಸ್ ಅವರಿಂದ ಅಭಿವೃದ್ಧಿಗೊಳಿಸಲಾದ ಸಂಪೂರ್ಣ 12 ವಾರಗಳ ಕೋರ್ಸ್ ಆಗಿದ್ದು, JavaScript, CSS ಮತ್ತು HTML ಅನ್ನು ಒಳಗೊಂಡ 24 ಕೈಗಾರಿಕಾ ಪಾಠಗಳನ್ನು ಒಳಗೊಂಡಿದೆ.
ಇದು ಆರಂಭಿಕರಿಗೆ ವೆಬ್ ಅಭಿವೃದ್ಧಿ ಮೂಲತತ್ವಗಳನ್ನು ಕಲಿಸಲು ಶಿಕ್ಷಣ ಕಾರ್ಯಕ್ರಮ ರೆಪೊಸಿಟರಿಯಾಗಿದೆ. ಕಾರ್ಯಕ್ರಮವು ಮೈಕ್ರೋಸಾಫ್ಟ್ ಕ್ಲೌಡ್ അഡ್ವೊಕೇಟ್ಸ್ দ্বারা ಅಭಿವೃದ್ಧಿಪಡಿಸಲಾದ ಸಮಗ್ರ 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 ಚಾಟ್ ಸಹಾಯಕ
- **ಇಂಟರ್ಯಾಕ್ಟಿವ್ ಕ್ವಿಜ್‌ಗಳು**: 48 ಕ್ವಿಜ್‌ಗಳು, ಪ್ರತಿಯೊಂದು 3 ಪ್ರಶ್ನೆಗಳೊಂದಿಗೆ (ಪಾಠದ ಪೂರ್ವ/ಪರೀಕ್ಷೆಗಳು)
- **ಹು-ಭಾಷಾ ಬೆಂಬಲ**: 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 ಸೆಟ್‌ಅಪ್ (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 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 format # Prettier ಮೂಲಕ ಸ್ವರೂಪಗೊಳಿಸಿ
npm start # API ಸರ್ವರ್ ಆರಂಭಿಸು
npm run lint # ESLint ಚಾಲನೆ
npm run format # Prettier ಬಳಸಿ ಸ್ವರೂಪಿತ ಮಾಡಿ
```
### ಬ್ರೌಸರ್ ವಿಸ್ತರಣೆ ಪ್ರಾಜೆಕ್ಟ್ಗಳು
### Browser Extension Projects
```bash
cd 5-browser-extension/solution
@ -59,224 +59,224 @@ npm install
# ಬ್ರೌಸರ್-ನಿರ್ದಿಷ್ಟ ವಿಸ್ತರಣೆ ಲೋಡಿಂಗ್ ಸೂಚನೆಗಳನ್ನು ಅನುಸರಿಸಿ
```
### ಸ್ಪೇಸ್ ಗೇಮ್ ಪ್ರಾಜೆಕ್ಟ್ಗಳು
### Space Game Projects
```bash
cd 6-space-game/solution
npm install
# ಬ್ರೌಸರ್‌ನಲ್ಲಿ index.html ತೆರೆಯಿರಿ ಅಥವಾ ಲೈವ್ ಸರ್ವರ್ ಅನ್ನು ಬಳಸಿ
# ಬ್ರೌಸರ್ ನಲ್ಲಿ index.html ಓಪನ್ ಮಾಡಿ ಅಥವಾ ಲೈವ್ ಸರ್ವರ್ ಬಳಸಿ
```
### ಚಾಟ್ ಪ್ರಾಜೆಕ್ಟ್ (Python ಬ್ಯಾಕೆಂಡ್)
### Chat Project (Python Backend)
```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**: quiz-app ಡೈರೆಕ್ಟರಿಯಲ್ಲಿ `npm run dev` ರನ್ ಮಾಡಿ
- **ಪ್ರಾಜೆಕ್ಟ್ಸ್**: HTML ಪ್ರಾಜೆಕ್ಟ್ಗಳಿಗೆ VS Code Live Server ವಿಸ್ತರಣೆ ಬಳಸಿ
- **API ಪ್ರಾಜೆಕ್ಟ್ಸ್**: ಪ್ರತ್ಯೇಕ API ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ `npm start` ರನ್ ಮಾಡಿ
- **ಕ್ವಿಜ್ ಅಪ್ಲಿಕೇಶನ್**: quiz-app ಡೈರೆಕ್ಟರಿಯಲ್ಲಿ `npm run dev` ರನ್ ಮಾಡಿ
- **ಪ್ರಾಜೆಕ್ಟ್‌ಗಳು**: HTML ಪ್ರಾಜೆಕ್ಟ್‌ಗಳಿಗೆ VS Code Live Server ವಿಸ್ತರಣೆ ಬಳಸಿ
- **API ಪ್ರಾಜೆಕ್ಟ್‌ಗಳು**: ಸಂಬಂಧಿತ API ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ `npm start` ರನ್ ಮಾಡಿ
## ಪರೀಕ್ಷೆ ಸೂಚನೆಗಳು
## Testing Instructions
### Quiz App ಪರೀಕ್ಷೆ
### Quiz App Testing
```bash
cd quiz-app
npm run lint # ಕೋಡ್ ಶೈಲಿ ಸಮಸ್ಯೆಗಳಿಗಾಗಿ ಪರಿಶೀಲಿಸಿ
npm run build # ನಿರ್ಮಾಣ ಯಶಸ್ವಿಯಾಗಿರುವುದನ್ನು ಪರಿಶೀಲಿಸಿ
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 ನಲ್ಲಿ ಕೋಡ್ ಉದಾಹರಣೆಗಳನ್ನು ಪರೀಕ್ಷಿಸಿ
- ಅನುವಾದಗಳು ಸರಿಯಾದ ರಚನೆಯನ್ನು ಕಾಯ್ದುಕೊಳ್ಳುತ್ತವೆಯೋ ಎಂದು ಪರಿಶೀಲಿಸಿ
- ಮಾರ್ಕ್ಡೌನ್ ಲಿಂಕುಗಳು ಮಾನ್ಯವಾಗಿದೆಯೇ ಪರಿಶೀಲಿಸಿ
- ಬ್ರೌಸರಿನಲಲಿ ಅಥವಾ Node.js ನಲ್ಲಿ ಕೋಡ್ ಉದಾಹರಣೆಗಳನ್ನು ಪರೀಕ್ಷಿಸಿ
- ಅನುವಾದಗಳು ಸರಿಯಾದ ರಚನೆಯನ್ನು ಕಾಪಾಡುತ್ತವೆಯೇ ನೋಡಿ
## ಕೋಡ್ ಶೈಲಿ ಮಾರ್ಗಸೂಚಿಗಳು
## Code Style Guidelines
### JavaScript
- ನವೀನ ES6+ ವಾಕ್ಯ ರಚನೆ ಬಳಸಿ
- ಪ್ರಾಜೆಕ್ಟ್‌ಗಳಲ್ಲಿ ನೀಡಲಾದ ESLint ನಿಯಮಗಳನ್ನು ಅನುಸರಿಸಿ
- ಶೈಕ್ಷಣಿಕ ಸ್ಪಷ್ಟತೆಗೆ ಅರ್ಥಪೂರ್ಣ ಚರ ಮತ್ತು ಫಂಕ್ಷನ್ ಹೆಸರುಗಳನ್ನು ಬಳಸಿ
- ಕಲಿಯುವವರಿಗೆ ಕ್ಲೀರ್ ಮಾಡುವ ಟಿಪ್ಪಣಿಗಳನ್ನು ಸೇರಿಸಿ
- Prettier ಅಳವಡಿಸಿರುವಲ್ಲಿ ಆಕಾರಣವನ್ನು ಅನುಸರಿಸಿ
- ಆಧುನಿಕ ES6+ ವಾಕ್ಯರಚನೆ ಬಳಸಿ
- ಪ್ರಾಜೆಕ್ಟ್‌ಗಳಲ್ಲಿರುವ ಸಾಮಾನ್ಯ ESLint ಸಂರಚನೆಗಳನ್ನು ಅನುಸರಿಸಿ
- ಶೈಕ್ಷಣಿಕ ಸ್ಪಷ್ಟತೆಗಾಗಿ ಅರ್ಥಪೂರ್ಣ ವರ್ಣನಾಮಗಳು ಮತ್ತು ಫಂಕ್ಷನ್ ಹೆಸರುಗಳನ್ನು ಬಳಸಿ
- ಕಲಿಕೆಗೆ ವಿವರಣೆ ಸುತ್ತುಮುತ್ತುಗಳನ್ನು ಸೇರಿಸಿ
- ಸ್ವತಃ ಸಂರಚಿತ Prettier ಮುಖಾಂತರ ಫಾರ್ಮ್ಯಾಟ್ ಮಾಡಿ
### HTML/CSS
- ಅರ್ಥಪೂರ್ಣ HTML5 ಅಂಶಗಳು
- ಪ್ರತಿಕ್ರಿಯಾಶೀಲ ವಿನ್ಯಾಸ ತತ್ವಗಳು
- ಸ್ಪಷ್ಟ ಶ್ರೇಣಿವರ್ಗೀಕರಣ ನಿಯಮಗಳು
- CSS ತಂತ್ರಗಳು ಕುರಿತು ಟಿಪ್ಪಣಿಗಳು ಕಲಿಯುವವರಿಗೆ
- ಪ್ರತಿಕ್ರಿಯಾತ್ಮಕ ವಿನ್ಯಾಸ ತತ್ವಗಳು
- ಸ್ಪಷ್ಟ ಕ್ಲಾಸ್ ಹೆಸರುಕರಣ ನಿಬಂಧನೆಗಳು
- CSS ತಂತ್ರಗಳನ್ನು ಕಲಿಕೆಗಾಗಿ ಟಿಪ್ಪಣಿಗಳು
### Python
- PEP 8 ಶೈಲಿ ಮಾರ್ಗಸೂಚಿಗಳು
- ಸ್ಪಷ್ಟ, ಶೈಕ್ಷಣಿಕ ಕೋಡ್ ಉದಾಹರಣೆಗಳು
- ಕಲಿಕ್‌ಗೆ ನೆರವಾಗುವ ಟೈಪ್ ಸಂದರ್ಶನೆಗಳು
- ಕಲಿಕೆಗೆ ಸಹಾಯಕವಾಗುವ ಟೈಪ್ ಸೂಚನೆಗಳು
### ಮಾರ್ಕ್‌ಡೌನ್ ಡಾಕ್ಯುಮೆಂಟೇಶನ್
### Markdown Documentation
- ಸ್ಪಷ್ಟ ಶೀರ್ಷಿಕೆ ಹಿರಾರ್ಿ
- ಭಾಷಾ ನಿರ್ದಿಷ್ಟ ಪದಗಳೊಂದಿಗೆ ಕೋಡ್ ಬ್ಲಾಕ್ಗಳು
- ಹೆಚ್ಚುವರಿ ಸಂಪನ್ಮೂಲಗಳಿಗೆ ಲಿಂಕ್‌ಗಳು
- ಚಿತ್ರಗಳು ಮತ್ತು ಸ್ಕ್ರೀನ್‌ಶಾಟ್‌ಗಳು `images/` ಡೈರೆಕ್ಟರಿಗಳಿಗೆ
- ಎಲ್ಲಾ ಚಿತ್ರಗಳಿಗೆ Alt ಪಠ್ಯವನ್ನು ಹಾಕಿ ಪ್ರವೇಶೀಯತೆಗಾಗಿ
- ಸ್ಪಷ್ಟ ಶೀರ್ಷಿಕೆ ಹಿರಾರ್ಿ
- ಭಾಷಾ ಸೂಚನೆಯೊಂದಿಗೆ ಕೋಡ್ ಬ್ಲಾಕ್ಗಳು
- ಹೆಚ್ಚುವರಿ ಸಂಪನ್ಮೂಲಗಳಿಗೆ ಲಿಂಕಗಳು
- `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 ನಿಯೋಜನೆ (Azure Static Web Apps)
### Quiz App Deployment (Azure Static Web Apps)
quiz-app ಅನ್ನು Azure Static Web Apps ನಿಯೋಜನೆಗಾಗಿ ಸಂರಚಿಸಲಾಗಿದೆ:
ಕ್ವಿಜ್-ಅಪ್ ಅನ್ನು Azure Static Web Apps ನಿಯೋಜನೆಗಾಗಿ ಸಂರಚಿಸಲಾಗಿದೆ:
```bash
cd quiz-app
npm run build # dist/ ಫೋಲ್ಡರನ್ನು ರಚಿಸುತ್ತದೆ
# ಮೆನ್‌ಗೆ ಪುಷ್ ಮಾಡುವಾಗ GitHub Actions ವರ್ಕ್‌ಫ್ಲೋ ಮೂಲಕ ಡಿಪ್ಲಾಯ್ ಮಾಡುತ್ತದೆ
npm run build # dist/ ಫೋಲ್ಡರ್ ಸಂಪಾದಿಸುತ್ತದೆ
# ಮೇನ್‌ಗೆ ಪುಷ್ ಮಾಡಿದಾಗ GitHub Actions ವರ್ಕ್‌ಫ್ಲೋ ಮೂಲಕ ನಿಯೋಜಿಸುತ್ತದೆ
```
Azure Static Web Apps ಸಂರಚನೆ:
- **ಅಪ್ಲಿಕೇಶನ್ ಸ್ಥಳ**: `/quiz-app`
- **ಔಟ್‌ಪುಟ್ ಸ್ಥಳ**: `dist`
- **ಕಾರ್ಯಪಟು**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
- **ಎಕ್ಸ್ಪೋರ್ಟ್ ಸ್ಥಳ**: `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 ಡಾಕ್ಯುಮೆಂಟೇಶನ್
### Docsify Documentation
```bash
npm install -g docsify-cli # Docsify ಅನ್ನು ಜಾಗತಿಕವಾಗಿ ಸ್ಥಾಪಿಸಿ
docsify serve # localhost:3000 ನಲ್ಲಿ ಸೇವೆ ಮಾಡಿ
npm install -g docsify-cli # ಡಾಕ್ಸಿಫೈ ಅನ್ನು ಗ್ಲೋಬಲ್ ಆಗಿ ಇನ್‌ಸ್ಟಾಲ್ ಮಾಡಿ
docsify serve # localhost:3000 ನಲ್ಲಿ ಸೇವೆ ನೀಡಿ
```
### ಪ್ರಾಜೆಕ್ಟ್-ನಿರ್ದಿಷ್ಟ ನಿರ್ಮಾಣಗಳು
### Project-specific Builds
ಪ್ರತಿಯೊಂದು ಪ್ರಾಜೆಕ್ಟ್ ಡೈರೆಕ್ಟರಿಗೆ ಅದರ ಸ್ವಂತ ನಿರ್ಮಾಣ ಪ್ರಕ್ರಿಯೆ ಇರಬಹುದು:
- Vue ಪ್ರಾಜೆಕ್ಟ್ಗಳು: `npm run build` ರನ್ ಮಾಡಿದರೆ ಪ್ರೊಡಕ್ಷನ್ ಬಂಡಲ್ ನಿರ್ಮಿಸುತ್ತದೆ
- ಸ್ಥಿರ (Static) ಪ್ರಾಜೆಕ್ಟ್ಗಳು: ಯಾವುದೇ ನಿರ್ಮಾಣ ಹಂತವಿಲ್ಲದೆ ಕಡತಗಳನ್ನು ನೇರವಾಗಿ ಸರ್ವ್ ಮಾಡುವುದು
ಪ್ರತಿ ಪ್ರಾಜೆಕ್ಟ್ ಡೈರೆಕ್ಟರಿಯು ತನ್ನದೇಯಾದ ಬಿಲ್ಡಿಂಗ್ ಪ್ರಕ್ರಿಯೆ ಇರಬಹುದು:
- Vue ಪ್ರಾಜೆಕ್ಟ್‌ಗಳು: `npm run build` ಮೂಲಕ ಉತ್ಪಾದನಾ ಬಂಡಲುಗಳನ್ನು ರಚಿಸುತ್ತದೆ
- ಸ್ಥಿರ ಪ್ರಾಜೆಕ್ಟ್ಗಳು: ನಿರ್ಮಾಣ ಹಂತವಿಲ್ಲದೆ ನೇರವಾಗಿ ಫೈಲುಗಳನ್ನು ಸೇವ್ ಮಾಡುತ್ತದೆ
## ಪುಲ್ ರಿಕ್ವೆಸ್ಟ್ ಮಾರ್ಗಸೂಚಿಗಳು
## Pull Request Guidelines
### ಶೀರ್ಷಿಕೆ ವಿನ್ಯಾಸ
### Title Format
ಬದಲಾವಣೆಯ ಕ್ಷೇತ್ರವನ್ನು ಸೂಚಿಸುವ ಸ್ಪಷ್ಟ, ವರ್ಣನಾತ್ಮಕ ಶೀರ್ಷಿಕೆಗಳನ್ನು ಬಳಸಿ:
ಬದಲಾವಣೆಯ ಕ್ಷೇತ್ರವನ್ನು ಸ್ಪಷ್ಟಪಡಿಸುವ ಶೀರ್ಷಿಕೆ ಬರೆದಿರಿ:
- `[Quiz-app] ಪಾಠ X ಗೆ ಹೊಸ ಕ್ವಿಜ್ ಸೇರಿಸಿ`
- `[Lesson-3] ಟೆರಾರಿಯಂ ಪ್ರಾಜೆಕ್ಟ್‌ನಲ್ಲಿ ಟೈಪೋ ಸರಿಪಡಿಸಿ`
- `[Translation] ಪಾಠ 5ಕ್ಕೆ ಸ್ಪ್ಯಾನಿಷ್ ಅನುವಾದ ಸೇರಿಸಿ`
- `[Docs] ಸೆಟ್‌ಅಪ್ ಸೂಚನೆಗಳನ್ನು ನವೀಕರಿಸಿ`
- `[Lesson-3] ಟೆರಾರಿಯಂ ಪ್ರಾಜೆಕ್ಟ್‌ನಲ್ಲಿ ಟೈಪೋ ಸರಿಪಡಿಸಿ`
- `[Translation] ಪಾಠ 5ೆ ಸ್ಪ್ಯಾನಿಷ್ ಅನುವಾದ ಸೇರಿಸಿ`
- `[Docs] ಸೆಟಪ್ ಸೂಚನೆಗಳನ್ನು ನವೀಕರಿಸಿ`
### ಅಗತ್ಯ ಪರಿಶೀಲನೆಗಳು
### Required Checks
PR ಸಲ್ಲಿಸುವ ಮೊದಲು:
ಪುಲ್ ರಿಕ್ವೆಸ್ಟ್ ಸಲ್ಲಿಸುವ ಮೊದಲು:
1. **ಕೋಡ್ ಗುಣಮಟ್ಟ**:
- ಸಂಬಂಧಿಸಿದ ಪ್ರಾಜೆಕ್ಟ್ ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ `npm run lint` ರನ್ ಮಾಡಿ
- ಪ್ರಭಾವಿತ ಪ್ರಾಜೆಕ್ಟ್ ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ `npm run lint` ರನ್ ಮಾಡಿ
- ಎಲ್ಲಾ ಲಿಂಟ್ ದೋಷಗಳು ಮತ್ತು ಎಚ್ಚರಿಕೆಗಳನ್ನು ಸರಿಪಡಿಸಿ
2. **ನಿರ್ಮಾಣ ಪ್ರಮಾಣೀಕರಣ**:
- ಅನ್ವಯಿಸಿದರೆ `npm run build` ರನ್ ಮಾಡಿ
- ಯಾವುದೇ ನಿರ್ಮಾಣ ದೋಷ ಇಲ್ಲದಿರಬೇಕು
2. **ಬಿಲ್ಡ್ ಪರಿಶೀಲನೆ**:
- ಅನ್ವಯಿಸುವಲ್ಲಿ `npm run build` ರನ್ ಮಾಡಿ
- ಯಾವುದೇ ಬಿಲ್ಡ್ ದೋಷಗಳಿಲ್ಲದಂತೆ ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ
3. **ಲಿಂಕ್ ಮಾನ್ಯತೆ ದೃಢೀಕರಣ**:
- ಎಲ್ಲಾ ಮಾರ್ಕ್‌ಡೌನ್ ಲಿಂಕ್‌ಗಳನ್ನು ಪರೀಕ್ಷಿಸಿ
- ಚಿತ್ರ ಕೊಂಡಿಗಳನ್ನು ಪರಿಶೀಲಿಸಿ
3. **ಲಿಂಕ್ ಮಾನ್ಯತೆ**:
- ಎಲ್ಲಾ ಮಾರ್ಕ್ಡೌನ್ ಲಿಂಕುಗಳನ್ನು ಪರೀಕ್ಷಿಸಿ
- ಚಿತ್ರ ಪೂರ್ಜನುಗಳು ಕಾರ್ಯರತವಾಗಿರುವುದನ್ನು ದೃಢಪಡಿಸಿ
4. **ವಿಷಯ ಪರಿಶೀಲನೆ**:
- ವ್ಯಾಕರಣ ಮತ್ತು SPELLCHECK ಮಾಡಿ
- ಕೋಡ್ ಉದಾಹರಣೆಗಳು ಸರಿಯಾಗಿವೆ ಮತ್ತು ಶಿಕ್ಷಣೋದ್ಯಶವಿರುವುದನ್ನು ಖಚಿತಪಡಿಸಿ
- ಅನುವಾದಗಳು ಮೂಲ ಅರ್ಥವನ್ನು ಕಾಯ್ದುಕೊಳ್ಳಲಿ
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 ವಿವರಣೆಯಲ್ಲಿ ಸಮಸ್ಯೆಗಳ ಸಂಖ್ಯೆಗಳ ಉಲ್ಲೇಖಿಸಿ (ಅನ್ವಯಿಸುವಲ್ಲಿ)
### ವಿಮರ್ಶಾ ಪ್ರಕ್ರಿಯೆ
### 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:
@ -289,120 +289,120 @@ CO_OP_TRANSLATOR_METADATA:
-->
```
## ಡೀಬಗ್ಗಿಂಗ್ ಮತ್ತು ಸಮಸ್ಯೆಗಳ ಪರಿಹಾರ
## Debugging and Troubleshooting
### ಸಾಮಾನ್ಯ ಸಮಸ್ಯೆಗಳು
### Common Issues
**Quiz app ಪ್ರಾರಂಭವಾಗುತ್ತಿಲ್ಲ**:
- 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 ಸರಿಯಾಗಿ ರಚಿಸಲಾಗಿದೆ ಎಂದು ಖಚಿತಪಡಿಸಿ
- ಬ್ರೌಸರ್ ಕನ್ಸೋಲ್ ದೋಷಗಳನ್ನು ಪರಿಶೀಲಿಸಿ
- ಬ್ರೌಸರ್-ನಿಷ್ಟ ವಿಸ್ತರಣೆ ಸ್ಥಾಪನೆ ಸೂಚನೆಗಳನ್ನು ಅನುಸರಿಸಿ
**Python ಚಾಟ್ ಪ್ರಾಜೆಕ್ಟ್ ಸಮಸ್ಯೆಗಳು**:
- OpenAI ಪ್ಯಾಕೇಜ್ ಸ್ಥಾಪಿಸಲಾಗಿದೆಯೇ: `pip install openai`
- GITHUB_TOKEN ಪರಿಸರ ಚರ ಅನ್ನು ಹೊಂದಿರುವುದನ್ನು ಖಚಿತಪಡಿಸಿ
- GitHub ಮಾದರಿಗಳ ಪ್ರವೇಶ ಹಕ್ಕುಗಳನ್ನು ಪರಿಶೀಲಿಸಿ
- 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 Live Server ವಿಸ್ತರಣೆ ಬಳಸಿ
- ನಿರಂತರ ರೂಪಕ್ಕೆ ESLint ಮತ್ತು Prettier ವಿಸ್ತರಣೆಗಳನ್ನು ಸ್ಥಾಪಿಸಿ
- JavaScript ಡೀಬಗ್ಗಿಂಗ್‌ಗಾಗಿ ಬ್ರೌಸರ್ ಡೆವ್‌ಟೂಲ್‌ಗಳನ್ನು ಬಳಸಿ
- Vue ಪ್ರಾಜೆಕ್ಟ್ಗಳಿಗೆ Vue DevTools ಬ್ರೌಸರ್ ವಿಸ್ತರಣೆ ಸ್ಥಾಪಿಸಿ
- HTML ಪ್ರಾಜೆಕ್ಟ್ಗಳಿಗೆ VS Code Live Server ವಿಸ್ತರಣೆ ಬಳಸಿ
- ಸರಳ ಸ್ವರೂಪಣಿಗಾಗಿ 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 ಪ್ರಾಜೆಕ್ಟ್ಗಳು
### Python Projects
- ವರ್ಚುವಲ್ ಎನ್ವಾಯರನ್ಮೆಂಟ್‌ಗಳನ್ನು ಬಳಸಿ: `python -m venv venv`
- ಅವಲಂಬನೆಗಳನ್ನು ನವೀಕರಿಸಿ
- GitHub ಟೋಕನ್‌ಗಳು ಕನಿಷ್ಠ ಅಗತ್ಯ ಅನುವಾದಗಳನ್ನು ಹೊಂದಿರಬೇಕು
- ವರ್ಚುವಲ್ ಪರಿಸರಗಳನ್ನು ಉಪಯೋಗಿಸಿ: `python -m venv venv`
- ಅವಲಂಬನೆಗಳನ್ನು ನವೀಕರಿಸಿ ಇಡಿ
- GitHub ಟೋಕನ್‌ಗಳು ಕನಿಷ್ಠ ಅಗತ್ಯ ಅನುಮತಿಗಳೊಂದಿಗೆ ಇರಬೇಕು
### GitHub ಮಾದರಿಗಳ ಪ್ರವೇಶ
### GitHub Models Access
- GitHub ಮಾದರಿಗಳಿಗೆ ವೈಯಕ್ತಿಕ ಪ್ರವೇಶ ಟೋಕನ್‌ಗಳು (PAT) ಅಗತ್ಯ
- ಟೋಕನ್‌ಗಳನ್ನು ಪರಿಸರ ಚರಗಳಾಗಿ ಸಂಗ್ರಹಿಸಿ
- ಟೋಕನ್ ಅಥವಾ ಸಾಂದರ್ಭಿಕತೆಗಳನ್ನು ಎಂದಿಗೂ ದಾಖಲಿಸಬಾರದು
- GitHub Models ಬಳಲಿಸಲು ವೈಯಕ್ತಿಕ ಪ್ರವೇಶ ಟೋಕನ್‌ಗಳು (PAT) ಅಗತ್ಯ
- ಟೋಕನ್‌ಗಳನ್ನು ಪರಿಸರ ವ್ಯತ್ಯಯಗಳಲ್ಲಿ ಸಂಗ್ರಹಿಸಿ
- ಟೋಕನ್‌ಗಳು ಅಥವಾ ಪ್ರಮಾಣಪತ್ರಗಳನ್ನು ಎಂದಿಗೂ ಕಮಿಟ್ ಮಾಡಬೇಡಿ
## ಹೆಚ್ಚುವರಿ ಟಿಪ್ಪಣಿಗಳು
## Additional Notes
### ಗುರಿ ಪ್ರೇಕ್ಷಕರು
### Target Audience
- ವೆಬ್ ಅಭಿವೃದ್ಧಿಯ ಪೂರ್ಣական ಪ್ರಾರಂಭಿಕರು
- ವಿದ್ಯಾರ್ಥಿಗಳು ಮತ್ತು ಸ್ವಯಂಶಿಕ್ಷಕರ
- ತರಗತಿ ಸ್ಥಳದಲ್ಲಿ ಕಾರ್ಯಕ್ರಮವನ್ನು ಬಳಸುವ ಶಿಕ್ಷಕರು
- ವಿಷಯ ಪ್ರವೇಶযোগ্যತೆ ಮತ್ತು ಕ್ರಮೇಣ ಕೌಶಲ್ಯ ಅಭಿವೃದ್ಧಿಗೆ ವಿನ್ಯಾಸಗೊಳಿಸಲಾಗಿದೆ
- ವೆಬ್ ಅಭಿವೃದ್ಧಿ ಸಂಪೂರ್ಣ ಆರಂಭಿಕರು
- ವಿದ್ಯಾರ್ಥಿಗಳು ಮತ್ತು ಸ್ವಯಂ ಅಧ್ಯಯನಿಗಳ
- ತರಗತಿಗಳಲ್ಲಿ ಕಾರ್ಯಕ್ರಮವನ್ನು ಬಳಕೆಮಾಡುವ ಶಿಕ್ಷಕರು
- ವಿಷಯ ಲಭ್ಯತೆ ಮತ್ತು ಹಂತ ಹಂತವಾಗಿ ಕೌಶಲ್ಯ ಅಭಿವೃದ್ಧಿಗೆ ವಿನ್ಯಾಸಗೊಳಿಸಲಾಗಿದೆ
### ಶೈಕ್ಷಣಿಕ ತತ್ವಶಾಸ್ತ್ರ
### Educational Philosophy
- ಪ್ರಾಜೆಕ್ಟ್ ಆಧಾರಿತ ಕಲಿಕಾ ದೃಷ್ಟಿಕೋ
- ನಿಯಮಿತ ಜ್ಞಾನ ಪರಿಶೀಲನೆಗಳು (ಕ್ವಿಜ್‌ಗಳು)
- ಕೈಗಾರಿಕ ಮೂಲದ ಕೋಡಿಂಗ್ ಅಭ್ಯಾಸಗಳು
- ವಾಸ್ತವ ಜಗತ್ತಿನ ಅನ್ವಯಿಕೆ ಉದಾಹರಣೆಗಳು
- ಫ್ರೇಮ್ವರ್ಕ್‌ಗಳ ಮುಂಚೆ ಮೂಲತತ್ತ್ವಗಳ ಮೇಲೆ ಗಮನ
- ಪ್ರಾಜೆಕ್ಟ್ ಆಧಾರಿತ ಕಲಿಕೆ ವಿಧಾ
- ನಿಯಮಿತ ಜ್ಞಾನ ಪರಿಶೋಧನಗಳು (ಕ್ವಿಜ್‌ಗಳು)
- ಕೈಯಿಂದ ಮಾಡಿಸುವ ಕೋಡಿಂಗ್ ಅಭ್ಯಾಸಗಳು
- ನಿಜಜೀವಿತ ಅನ್ವಯ ಉದಾಹರಣೆಗಳು
- ಫ್ರೇಮ್ವರ್ಕ್‌ಗಳಿಗೆ ಮೊದಲು ಮೂಲಭೂತ ವಿಷಯಗಳ ಮೇಲೆ ಗಮನ
### ರೆಪೊಸಿಟರಿ ನಿರ್ವಹಣೆ
### Repository Maintenance
- ಶ್ರಮಶೀಲ ಕಲಿಯುವ ಹಾಗೂ ಕೊಡುಗೆದಾರರ ಸಮುದಾಯ
- ನಿರಂತರವಾಗಿ ಅವಲಂಬನೆಗಳು ಮತ್ತು ವಿಷಯಕ್ಕೆ ಅಪ್ಡೇಟ್ಗಳು
- ನಿರ್ವಹಕರಿಂದ ಸಮಸ್ಯೆಗಳು ಮತ್ತು ಚರ್ಚೆಗಳ ಮೇಲ್ವಿಚಾರಣ
- GitHub Actions ಮೂಲಕ ಅನುವಾದ ಸ್ವಯಂಚಾಲಿತ ನವೀಕರಣಗಳು
- ಕಲಿಯುವವರು ಮತ್ತು ಕೊಡುಗೆದಾರರ ಚಟುವಟಿಕೆಯಿಂದ ಸಕ್ರಿಯ ಸಮುದಾಯ
- ಅವಲಂಬನೆಗಳು ಮತ್ತು ವಿಷಯದ ನಿಯಮಿತ ನವೀಕರಣಗಳು
- ನಿರ್ವಹಕರಿಂದ ಸಮಸ್ಯೆಗಳು ಮತ್ತು ಚರ್ಚೆಗಳು ಗಮನಿಸಲಾಗುತ್ತದ
- GitHub Actions ಮೂಲಕ ಅನುವಾದ ನವೀಕರಣಗಳು ಸ್ವಯಂಚಾಲಿತ
### ಸಂಬಂಧಿತ ಸಂಪನ್ಮೂಲಗಳು
### Related Resources
- [Microsoft Learn ಘಟಕಗಳು](https://docs.microsoft.com/learn/)
- [ವಿದ್ಯಾರ್ಥಿ ಹಬ್ ಸಂಪನ್ಮೂಲಗಳು](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) ಕಲಿಯುವವರಿಗೆ ಶಿಫಾರಸು
- ಹೆಚ್ಚುವರಿ ಕೋರ್ಸ್‌ಗಳು: ಜನನಾತ್ಮಕ AI, ಡೇಟಾ ಸೈನ್ಸ್, ML, IoT ಕೋರ್ಸ್‌ಗಳು ಲಭ್ಯ
- [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, ಡೇಟಾ ವೈಜ್ಞಾನಿಕ, ಮಾನವಪ್ರಣಾಳಿ, IoT ಕೋರ್ಸ್‌ಗಳು ಲಭ್ಯ
### ವಿಶೇಷ ಪ್ರಾಜೆಕ್ಟ್ಗಳೊಂದಿಗೆ ಕೆಲಸ
### Working with Specific Projects
ವೈಯಕ್ತಿಕ ಪ್ರಾಜೆಕ್ಟ್ಗಳ ವಿವರ ಸೂಚನೆಗಳಿಗಾಗಿ README ಕಡತಗಳನ್ನು ನೋಡಿ:
ನಿರ್ದಿಷ್ಟ ಪ್ರಾಜೆಕ್ಟ್‌ಗಳ ವಿವರವಾದ ಸೂಚನೆಗಳಿಗೆ, ಈ ಕೆಳಗಿನ README ಫೈಲುಗಳನ್ನು ನೋಡಿ:
- `quiz-app/README.md` - Vue 3 ಕ್ವಿಜ್ ಅಪ್ಲಿಕೇಶನ್
- `7-bank-project/README.md` - ಪ್ರಾಮಾಣೀಕತೆ ಜೊತೆಗೆ ಬ್ಯಾಂಕಿಂಗ್ ಅಪ್ಲಿಕೇಶನ್
- `7-bank-project/README.md` - ನಂಬಿಕೊಳ್ ಬ್ರೋಕಾರಿಕರಣದೊಂದಿಗೆ ಬ್ಯಾಂಕಿಂಗ್ ಅಪ್ಲিকೇಶನ್
- `5-browser-extension/README.md` - ಬ್ರೌಸರ್ ವಿಸ್ತರಣೆ ಅಭಿವೃದ್ಧಿ
- `6-space-game/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 -->

@ -1,7 +1,7 @@
{
"1-getting-started-lessons/1-intro-to-programming-languages/README.md": {
"original_hash": "bec5e35642176d9e483552bfc82996d8",
"translation_date": "2026-03-06T14:08:57+00:00",
"original_hash": "d5eeb6e975b5864d8da52d4a41941f8d",
"translation_date": "2026-03-27T21:01:50+00:00",
"source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md",
"language_code": "ml"
},
@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-03-06T14:24:25+00:00",
"translation_date": "2026-03-27T21:10:24+00:00",
"source_file": "AGENTS.md",
"language_code": "ml"
},

@ -2,27 +2,27 @@
## Project Overview
ഇത് ആരംഭക്കാർക്ക് വെബ് ഡെവലപ്പ്മെന്റ് അടിസ്ഥാനങ്ങൾ പഠിപ്പിക്കാനുള്ള ഒരു വിദ്യാഭ്യാസ രാഷ്ട്രീയ ഗ്രന്ഥശേഖരമാണ്. 24 ഹാൻഡ്‌സ്-ഓൺ പാഠങ്ങളുമായി ജാവാസ്ക്രിപ്റ്റ്, CSS, HTML ഉൾപ്പെടുന്ന Microsoft Cloud Advocates വികസിപ്പിച്ചെടുത്ത സമഗ്രമായ 12-ആഴ്ചക്കാല കോഴ്സ് ആണ് ഈ പാഠ്യപദ്ധതി.
ഇത് വെബ് ഡെവലപ്പ്മെന്റ് അടിസ്ഥാനങ്ങൾ തുടങ്ങുന്നവർക്കായി പാഠ്യപദ്ധതി പഠിപ്പിക്കുന്ന ഒരു വിദ്യാഭ്യാസ കോഴ്സ് റിപ്പോസിറ്ററിയാണ്. Microsoft Cloud Advocates വികസിപ്പിച്ച 12-ആഴ്ചകളുള്ള സമഗ്ര കോഴ്സ്, 24 ഹസ്തസംവൃദ്ധ പാഠങ്ങൾ ഉൾപ്പെടുത്തുകയും ജാവാസ്ക്രിപ്റ്റ്, CSS, HTML മുകളിൽ കാര്യക്ഷമമായി പഠിപ്പിക്കുകയും ചെയ്യുന്നു.
### Key Components
- **Educational Content**: പ്രോജക്ട് അടിസ്ഥാനമാക്കിയുള്ള മോഡ്യൂളുകളായി 24 ക്രമിത പാഠങ്ങൾ
- **Practical Projects**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, AI Chat Assistant
- **Interactive Quizzes**: ഓരോ പാഠത്തിനും 3 ചോദ്യങ്ങളുള്ള 48 ക്വിസുകൾ (മുൻകൂർ/പുറം-പാഠ വിലയിരുത്തലുകൾ)
- **Multi-language Support**: GitHub Actions വഴി 50+ ഭാഷകളിലേക്ക് സ്വയമേവ വിവർത്തനം
- **Technologies**: HTML, CSS, ജാവാസ്ക്രിപ്റ്റ്, 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,9 +46,9 @@ npm run lint # ESLint പ്രവർത്തിപ്പിക്കു
```bash
cd 7-bank-project/api
npm install
npm start # എപി‌ഐ സർവർ ആരംഭിക്കുക
npm run lint # ESLint പ്രവർത്തിപ്പിക്കുക
npm run format # Prettier ഉപയോഗിച്ച് ഫോർമാറ്റചെയ്യുക
npm start # API സർവർ ആരംഭിക്കുക
npm run lint # ESLint ഓടിക്കുക
npm run format # Prettier ഉപയോഗിച്ച് ഫോർമാറ്റചെയ്യുക
```
### Browser Extension Projects
@ -56,7 +56,7 @@ npm run format # Prettier ഉപയോഗിച്ച് ഫോർമാറ
```bash
cd 5-browser-extension/solution
npm install
# ബ്രൗസർ-നির്ദിഷ്ടമായ എക്‌സ്റ്റൻഷൻ ലോഡിംഗ് നിർദേശങ്ങൾ പാലിക്കുക
# ബ്രൗസറിനനുസരിച്ചുള്ള എക്സ്റ്റെൻഷൻ ലോഡിംഗ് നിര്‍ദ്ദേശങ്ങൾ പാലിക്കുക
```
### Space Game Projects
@ -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 അക്കൗണ്ടിൽ റിപ്പോസിറ്ററി ഫോർക്ക് ചെയ്യുക**
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 Live Server എക്‌സ്റ്റൻഷൻ ഉപയോഗിക്കുക
- **API പ്രോജക്റ്റുകൾ**: അനുയോജ്യമായ API ഡയറക്ടറികളിൽ `npm start` ഓടിക്കുക
- **ഡോക്യൂമെന്റേഷൻ**: റൂട്ട് ഡയറക്‌ടറിയിൽ `docsify serve` ഓടിക്കുക (പോർട്ട് 3000)
- **Quiz App**: quiz-app ഡയറക്‌ടറിയിൽ `npm run dev` റൺ ചെയ്യുക
- **പ്രോജക്റ്റുകൾ**: HTML പ്രോജക്റ്റുകൾക്കായി VS Code ലൈവ് സർവർ എക്സ്റ്റെൻഷൻ ഉപയോഗിക്കുക
- **API Projects**: അനുയോജ്യമായ API ഡയറക്ടറികളിൽ `npm start` ഓടിക്കുക
## Testing Instructions
@ -111,7 +111,7 @@ python api.py
```bash
cd quiz-app
npm run lint # കോഡ് സ്റ്റൈൽ പ്രശ്നങ്ങൾ പരിശോധിക്കുക
npm run build # നിർമ്മാണം വിജയിക്കുന്നോ എന്ന് സ്ഥിരീകരിക്കുക
npm run build # ബിൽഡ് വിജയകരമായതായി സ്ഥിരീകരിക്കുക
```
### Bank API Testing
@ -119,164 +119,164 @@ npm run build # നിർമ്മാണം വിജയിക്കുന
```bash
cd 7-bank-project/api
npm run lint # കോഡ് സ്റ്റൈൽ പ്രശ്നങ്ങൾ പരിശോധിക്കുക
node server.js # തെറ്റുകൾ കൂടാതെ സെർവർ തുടങ്ങുന്നതായി ഉറപ്പാക്കുക
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 ടെക്സ്റ്റ
- തെളിഞ്ഞ തലവാചക ഘടന
- കോഡ് ബ്ലോക്കുകൾ ഭാഷ നിർദ്ദേശത്തോടെ
- അധിക സ്രോതസുകൾക്ക് ലിങ്കുകൾ
- `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)
quiz-app Azure Static Web Apps നിർമാണത്തിനുള്ള ക്രമീകരണമുള്ളതാണ്:
quiz-app Azure Static Web Apps ഡിസ്പ്ലോയ്മെന്റിനായി കോൺഫിഗർ ചെയ്‌തിരിക്കുന്നു:
```bash
cd quiz-app
npm run build # dist/ ഫോൾഡർ സൃഷ്ടിക്കുന്നു
# മെയിന്‍ ബ്രാഞ്ചിലേക്ക് പുഷ് ചെയ്തപ്പോൾ GitHub Actions വർക്‌ഫ്ലോ വഴി ഡിപ്പ്ലോയ്ചെയ്യുന്നു
npm run build # dist/ ഫോൾഡർ സൃഷ്ടിക്കുന്നു
# പ്രധാനത്തിലേക്ക് പുഷ് ചെയ്‌തപ്പോൾ GitHub Actions വർക്‌ഫ്ലോ വഴി വിന്യസിക്കുന്നു
```
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 serve # ലോക്കൽഹോസ്റ്റ്: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] പാഠം X ക്വിസ് പുതിയതായി ചേർക്കുക`
- `[Lesson-3] ടെറേറിയം പ്രോജക്റ്റിൽ ടൈപ്പോ തിരുത്തുക`
- `[Translation] പാഠം 5 സൂപ്പള്ളി പരിഭാഷ ചേർക്കുക`
- `[Docs] സജ്ജീകരണ നിർദ്ദേശങ്ങൾ പുതുക്കുക`
### Required Checks
പുൾ റിക്വസ്റ്റ് സമർപ്പിക്കുന്ന മുൻപ്:
പുൾ റിക്വസ്റ്റ് സമർപ്പിക്കുന്നതിന് മുമ്പ്:
1. **കോഡ് ഗുണനിലവാരം**:
- ബാധിച്ച പ്രോജക്ട് ഡയറക്ടറികളിൽ `npm run lint` ഓടിക്കുക
- എല്ലാ ലിന്റ് പിശകുകളും മുന്നറിയിപ്പുകളും പരിഹരിക്കുക
1. **കോഡ് ഗുണനിലവാരം**:
- ബാധകമായ പ്രോജക്റ്റ് ഡയറക്‌ടറികളിൽ `npm run lint` ഓടിക്കുക
- എല്ലാ ലിന്റിംഗ് പിശകുകളും മുന്നറിയിപ്പുകളും പരിഹരിക്കുക
2. **ബിൽഡ് സ്ഥിരീകരണം**:
- പ്രയോഗിക്കാവുന്നെങ്കിൽ `npm run build` ഓടിക്കുക
- ബിൽഡിൽ പിശകുകൾ ഇല്ലെന്ന് ഉറപ്പാക്കുക
2. **ബിൽഡ് സ്ഥിരീകരണം**:
- ആവശ്യമായെങ്കിൽ `npm run build` ഓടിക്കുക
- ബിൽഡ് പിശകുകൾ ഇല്ലാത്തതാണ് ഉറപ്പാക്കുക
3. **ലിങ്ക് പരിശോധന**:
- എല്ലാ മാർക്ക്‌ഡൗൺ ലിങ്കുകളും പരീക്ഷിക്കുക
- ചിത്രങ്ങളുടെ റഫറൻസുകൾ ശരിയാണെന്ന് പരിശോധിക്കുക
3. **ലിങ്ക് പരിശോധന**:
- എല്ലാ മാർക്ക്ഡൗൺ ലിങ്കുകളും പരിശോദിക്കുക
- ചിത്ര റഫറൻസുകൾ ശരിയാണെന്ന് ഉറപ്പാക്കുക
4. **സാമഗ്രിaval**:
- വർത്തനത്തിൽ പിശകുകളും വ്യാകരണവും പരിശോധിക്കുക
- കോഡ് ഉദാഹരണങ്ങൾ ശരിയാണെന്ന് ഉറപ്പാക്കുക, വിദ്യാഭ്യാസത്തിന് അനുയോജ്യമായിരിക്കണം
- വിവർത്തനങ്ങൾ യഥാർത്ഥ അർത്ഥം നിലനിർത്തുന്നതായി ഉറപ്പാക്കുക
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 Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) പാലിക്കുക
- വിശദമായി മാർഗനിർദേശങ്ങൾക്ക് [CONTRIBUTING.md](./CONTRIBUTING.md) നോക്കുക
- സംബന്ധിച്ചെങ്കിൽ PR വിവരണത്തിൽ ഇഷ്യൂ നമ്പറുകൾ അടക്കം ചെയ്യുക
### Review Process
- 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 പതിപ്പ് കുറഞ്ഞത് 10 അല്ലെങ്കിൽ അതിലധികമെന്ന് ഉറപ്പാക്കുക
- പോർട്ട് 이미 ഉപയോഗത്തിലാണ് എന്ന് പരിശോധിക്കുക
- എല്ലാ ആശ്രിതങ്ങളും ഇൻസ്റ്റാൾ ചെയ്തു എന്ന് ഉറപ്പാക്കുക `npm install`
**API സർവർ തുടങ്ങുന്നില്ല**:
- Node.js വേർഷൻ കുറഞ്ഞത് (നോഡ് >=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 Live Server എക്സ്റ്റൻഷൻ ഉപയോഗിക്കുക
- സ്ഥിരതയുള്ള ഫോർമാറ്റിങ്ങിനായി ESLint, Prettier എക്സ്റ്റൻഷനുകൾ ഇൻസ്റ്റാൾ ചെയ്യുക
- ജാവാസ്ക്രിപ്റ്റ് ഡീബഗിനായി ബ്രൗസർ ഡെവ്‌ടൂൾസ് ഉപയോഗിക്കുക
- 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 Models-ൽ പ്രവേശിക്കാൻ പേഴ്സണൽ ആക്‌സസ് ടോകണുകൾ (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) പഠിക്കവർക്ക്ഗൾക്ക് ശുപാർശ ചെയ്യപ്പെടുന്നു
- അധിക കോഴ്സുകൾ: Generative AI, Data Science, 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 ചാറ്റ് അസിസ്റ്റന്റ് പ്രോജക്റ്റ്
വിവര ആവശ്യമായ വ്യക്തിഗത പ്രോജക്റ്റുകളിലേക്കുള്ള നിർദ്ദേശങ്ങൾ:
- `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 -->

@ -1,7 +1,7 @@
{
"1-getting-started-lessons/1-intro-to-programming-languages/README.md": {
"original_hash": "bec5e35642176d9e483552bfc82996d8",
"translation_date": "2026-03-06T14:01:40+00:00",
"original_hash": "d5eeb6e975b5864d8da52d4a41941f8d",
"translation_date": "2026-03-27T20:56:59+00:00",
"source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md",
"language_code": "te"
},
@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-03-06T14:22:58+00:00",
"translation_date": "2026-03-27T21:08:45+00:00",
"source_file": "AGENTS.md",
"language_code": "te"
},

@ -1,282 +1,282 @@
# AGENTS.md
## Project Overview
## ప్రాజెక్ట్ అవలోకనం
ఇది ప్రారంభ స్థాయి వారికి వెబ్ అభివృద్ధి మూలసూత్రాలు నేర్పడానికి ఒక విద్యాసంబంధి విధాన గ్రంథాలయము. ఈ విధాన గ్రంథాలయం Microsoft Cloud Advocates చేత రూపొందించిన సమగ్ర 12 వారాల కోర్స్, 24 హ్యాండ్‌‌ఆన్ పాఠాలు జావాస్క్రిప్ట్, CSS, మరియు HTML ని కవర్ చేస్తుంది.
ఇది ప్రారంభదశలో ఉన్న వారికి వెబ్ అభివృద్ధి మూలాలను బోధించేందుకు రూపొందించిన విద్యాసంబంధి పాఠ్యక్రమం గల రిపాజిటరీ. ఈ పాఠ్యక్రమం Microsoft Cloud Advocates ద్వారా అభివృద్ధి చేయబడిన 12 వారాల సమగ్ర కోర్స్, ఇందులో JavaScript, CSS, మరియు HTML పై 24 హాండ్స్-ఆన్ పాఠ్యాలును కలిగి ఉంది.
### Key Components
### ముఖ్య భాగాలు
- **Educational Content**: 24 నిర్మిత పాఠాలు ప్రాజెక్ట్ ఆధారిత మాడ్యూల్‌లుగా ఆర్గనైజ్ చేయబడ్డాయి
- **Practical Projects**: Terrarium, టైపింగ్ ఆట, బ్రౌజర్ ఎక్స్‌టెన్షన్, స్పేస్ గేమ్, బ్యాంకింగ్ యాప్, కోడ్ ఎడిటర్, మరియు AI చాట్ అసిస్టెంట్
- **Interactive Quizzes**: 3 ప్రశ్నలతో కూడిన 48 క్విజ్‌లు (పాఠం ముందుకు/నీటి పరీక్షలు)
- **Multi-language Support**: GitHub Actions ద్వారా 50+ భాషలకి ఆటోమేటిక్ అనువాదాలు
- **Technologies**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI ప్రాజెక్టులకు)
- **విద్యాసంబంధి విషయాలు**: ప్రాజెక్టు ఆధారిత మాడ్యూల్స్‌లో 24 నిర్మిత పాఠ్యాలు
- **ప్రాక్టికల్ ప్రాజెక్టులు**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, మరియు AI Chat సహాయకుడు
- **ఇంటరాక్టివ్ క్విజ్‌లు**: ప్రతి పాఠ్యానికి 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 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 lint # ESLint అమలు చేయండి
npm run format # Prettier తో ఫార్మాట్ చేయండి
```
### Browser Extension Projects
### బ్రౌజర్ విస్తరణ ప్రాజెక్టులు
```bash
cd 5-browser-extension/solution
npm install
# బ్రౌజర్-ప్రత్యేక\Extension లోడ్ చేయడం సంబంధించిన సూచనలను అనుసరించండి
# బ్రౌజర్-ప్రత్యేక ఎక్స్‌టెన్షన్ లోడ్ చేయు సూచనలను అనుసరించండి
```
### Space Game Projects
### స్పేస్ గేమ్ ప్రాజెక్టులు
```bash
cd 6-space-game/solution
npm install
# బ్రౌజర్ లో index.html ని తెరవండి లేదా Live Server ఉపయోగించండి
# బ్రౌజర్‌లో index.htmlని öffnen చేయండి లేదా Live Server ఉపయోగించండి
```
### 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 Live Server ఎక్స్‌టెన్షన్ ఉపయోగించండి
- **API ప్రాజెక్టులు**: సంబంధిత API డైరెక్టరీలలో `npm start` ను నడపండి
- **డాక్యుమెంటేషన్**: రూట్‌లో `docsify serve` ఆరంభించండి (పోర్ట్ 3000)
- **క్విజ్ యాప్**: quiz-app డైరెక్టరీలో `npm run dev` ఆడించండి
- **ప్రాజెక్టులు**: HTML ప్రాజెక్టుల కోసం VS Code Live Server ఇన్‌స్టలేషన్ ఉపయోగించండి
- **API ప్రాజెక్టులు**: సంబంధిత API డైరెక్టరీలలో `npm start` ఆడించండి
## Testing Instructions
## పరీక్షా సూచనలు
### Quiz App Testing
### క్విజ్ యాప్ పరీక్షా విధానం
```bash
cd quiz-app
npm run lint # కోడ్ శైలి సమస్యలను తనిఖీ చేయండి
npm run build # నిర్మాణం విజయవంతమయ్యిందా అని ధృవీకరించండి
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 సదుపాయం ఉన్న చోట ఫార్మాట్ చేయండి
- ప్రాజెక్టుల్లో ఇవ్వబడ్డ స్టాండర్డ్ ESLint కాన్ఫిగరేషన్లను పాటించండి
- విద్యాసంబంధ స్పష్టత కోసం అర్థవంతమైన వేరియబుల్ మరియు ఫంక్షన్ పేర్లను ఉపయోగించండి
- అభ్యాసకులకు భావనలను వివరించే కామెంట్లు జోడించండి
- గలిగినప్పుడు Prettierతో ఫార్మాట్ చేయండి
### HTML/CSS
- సేమాంటిక్ HTML5 ఎలిమెంట్లు
- రెస్పాన్సివ్ డిజైన్ సిద్ధాంతాలు
- స్పష్టమైన క్లాస్ నేమ్ నియమాలు
- CSS సాంకేతికాలను వివరిస్తూ కామెంట్లు
- సీమాంటిక్ HTML5 ఎలిమెంట్స్
- ప్రతిస్పందనాత్మక డిజైన్ సూత్రాలు
- క్లియర్ క్లాస్ నేమింగ్ కన్వెన్షన్లు
- అభ్యాసకులకు CSS పద్ధతులపై కామెంట్లు
### Python
### పైథాన్
- PEP 8 శైలి మార్గదర్శకాలు
- స్పష్టమైన, విద్యాసంబంధి కోడ్ ఉదాహరణలు
- నేర్చుకోవడానికి ఉపయోగకరమైన టైప్ హింట్లు
- స్పష్టమైన, విద్యాసంబంధ కోడ్ నమూనాలు
- నేర్చుకోవడానికి సహాయకంగా టైప్ హింట్లు
### Markdown Documentation
### మార్క్డౌన్ డాక్యుమెంటేషన్
- స్పష్టమైన హెడ్డింగ్ క్రమం
- భాష నిర్దేశంతో కోడ్ బ్లాక్‌లు
- క్లియర్ హెడింగ్ హైరార్కీ
- భాషా స్పెసిఫికేషన్ ఉన్న కోడ్ బ్లాక్‌లు
- అదనపు వనరులకు లింకులు
- `images/` డైరెక్టరీలలో స్క్రీన్‌షాట్‌లు మరియు చిత్రాలు
- యాక్సెసిబిలిటీకి చిత్రాలకి Alt టెక్స్ట్
- screenshots మరియు images/ ఫోల్డర్ లో చిత్రాలు
- పునర్వినియోగం కోసం చిత్రాల alt టెక్స్ట్
### File Organization
### ఫైల్ సాతత్యం
- పాఠాలు సీరియల్ నంబర్లతో (1-getting-started-lessons, 2-js-basics, మొదలైనవి)
- ప్రతి ప్రాజెక్టులో `solution/` మరియు చాలాసార్లు `start/` లేదా `your-work/` ఫోల్డర్‌లు
- పాఠానుసార చిత్రాలు `images/` ఫోల్డర్‌లలో నిల్వ
- పాఠ్యాలు వరుస సంఖ్యలుగా (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/ ఫోల్డర్ సృష్టిస్తుంది
# ప్రధాన బ్రాంచ్‌కు పుష్ చేసినప్పుడు GitHub Actions వర్క్‌ఫ్లో ద్వారా రెడీ చేస్తుంది
# మైన్ కు పుష్ చేసినప్పుడు GitHub Actions వర్క్‌ఫ్లో ద్వారా ఆమోదిస్తుంది
```
Azure Static Web Apps కాన్ఫిగరేషన్:
- **App location**: `/quiz-app`
- **Output location**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
- **యాప్ లొకేషన్**: `/quiz-app`
- **అవుట్‌పుట్ లొకేషన్**: `dist`
- **వర్క్‌ఫ్లో**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Documentation PDF Generation
### డాక్యుమెంటేషన్ PDF సృష్టి
```bash
npm install # docsify-to-pdf ని ఇన్‌స్టాల్ చేయండి
npm run convert # docs నుండి PDF సృష్టించండి
npm install # docsify-to-pdf న ఇన్‌స్టాల్ చేయండి
npm run convert # docs నుండి PDF ని సృష్టించండి
```
### Docsify Documentation
### Docsify డాక్యుమెంటేషన్
```bash
npm install -g docsify-cli # Docsifyను గ్లోబల్‌గా ఇన్‌స్టాల్ చేయండి
docsify serve # localhost:3000పై సేవ్ చేయండి
npm install -g docsify-cli # Docsify ను గ్లోబల్‌గా ఇన్‌స్టాల్ చేయండి
docsify serve # లోకల్‌హోస్ట్:3000 పైన సర్వ్ చేయండి
```
### Project-specific Builds
### ప్రాజెక్ట్-ప్రత్యేక బిల్డ్లు
ప్రతి ప్రాజెక్టు డైరెక్టరీకు తమ దేనిగానో బిల్డ్ ప్రాసెస్ ఉండవచ్చు:
- Vue ప్రాజెక్టులు: `npm run build` తో ప్రొడక్షన్ బండిల్స్ తయారు చేస్తుంది
- స్టాటిక్ ప్రాజెక్టులు: బిల్డ్ స్టెప్ లేదు, ఫైళ్లు నేరుగా సర్వ్ చేయబడతాయి
ప్రతి ప్రాజెక్టు డైరెక్టరీకి మీ స్వంత బిల్డ్ ప్రక్రియ ఉండొచ్చు:
- Vue ప్రాజెక్టులు: `npm run build` ప్రొడక్షన్ బండిల్స్ సృష్టిస్తుంది
- స్థిర ప్రాజెక్టులకు: బిల్డ్ దశ లేదు, ఫైల్స్ నేరుగా సర్వ్ చేయండి
## Pull Request Guidelines
## పుల్ల్ రిక్వెస్ట్ మార్గదర్శకాలు
### Title Format
### శీర్షిక ఆకృతి
మార్పు ప్రాంతాన్ని సూచించే స్పష్టమైన, వివరణాత్మక శీర్షికలు ఉపయోగించండి:
- `[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`
మార్పు ప్రాంతాన్ని సూచించే స్పష్టమైన, వివరణాత్మక శీర్షికలు ఉపయోగించండి:
- `[Quiz-app] పాఠం X కోసం కొత్త క్విజ్ జోడించండి`
- `[Lesson-3] terrarium ప్రాజెక్టులో టైపో సరిచేయండి`
- `[Translation] పాఠం 5కి స్పానిష్ అనువాదం జోడించండి`
- `[Docs] సెటప్ సూచనలు నవీకరించండి`
### Required Checks
### అవసరమైన తనిఖీలు
PR సమర్పించడానికి ముందు:
PR సమర్పించ ముందు:
1. **కోడ్ నాణ్యత**:
- ప్రభావిత ప్రాజెక్టు డైరెక్టరీల్లో `npm run lint` నడపండి
- అన్ని లింట్ లోపాలు మరియు హెచ్చరికలు సరిదిద్దండి
- ప్రభావిత ప్రాజెక్టు డైరెక్టరీలలో `npm run lint` నిర్వహించండి
- అన్ని లింట్ లోపాలు మరియు హెచ్చరికలు పరిష్కరించండి
2. **బిల్డ్ ధృవీకరణ**:
- అవసరమైతే `npm run build` నడపండి
- ఎలాంటి బిల్డ్ ఎర్రర్లు లేవని నిర్ధారించుకోండి
- వర్తించగలిగితే `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 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 వర్క్‌ఫ్లో ఉపయోగిస్తుంది
- GitHub Actions ద్వారా co-op-translator వర్క్‌ఫ్లోను ఉపయోగిస్తుంది
- 50+ భాషలకు ఆటోమేటిక్ అనువాదాలు చేస్తుంది
- మూల ఫైళ్లు ప్రధాన డైరెక్టరీలలో ఉంటాయి
- అనువదించిన ఫైళ్లు `translations/{language-code}/` ఫోల్డర్‌లలో ఉంటాయి
- అనువద ఫైళ్లు `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:
@ -289,120 +289,120 @@ 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 సరైన ఫార్మాట్‌లో ఉందా చెక్ చేయండి
- బ్రౌజర్ కన్సోల్ లో ఎర‍ర్స్ పరిశీలించండి
- బ్రౌజర్-ప్రత్యేక విస్తరణ ఇన్స్‌టలేషన్ సూచనలు అనుసరించండి
**Python చాట్ ప్రాజెక్ట్ సమస్యలు**:
- OpenAI ప్యాకేజీ ఇన్‌స్టాల్ అయ్యిందా: `pip install openai`
- GITHUB_TOKEN ఎన్విరాన్‌మెంట్ వేరియబుల్ సెట్ అయిందా
- GitHub మోడల్స్ యాక్సెస్ అనుమతులు సరి చూసుకోండి
- 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 లో Live Server ఎక్స్‌టెన్షన్ ఉపయోగించండి
- ESLint మరియు Prettier ఎక్స్‌టెన్షన్లు ఫార్మాటింగ్ కోసం ఇన్‌స్టాల్ చేసుకోండి
- జావాస్క్రిప్ట్ డీబగ్గింగ్ కోసం బ్రౌజర్ DevTools ఉపయోగించండి
- Vue ప్రాజెక్టులకు Vue DevTools బ్రౌజర్ ఎక్స్‌టెన్షన్ ఇన్స్టాల్ చేయండి
- HTML ప్రాజెక్టుల కోసం VS Code లో Live Server ఎక్స్‌టెన్షన్ ఉపయోగించండి
- సుస్థిర ఫార్మాటింగ్ కోసం ESLint మరియు Prettier ఎక్స్‌టెన్షన్లు ఇన్స్టాల్ చేయండి
- JavaScript డీబగ్గింగ్ కోసం బ్రౌజర్ DevTools ఉపయోగించండి
- Vue ప్రాజెక్టులకు Vue DevTools బ్రౌజర్ ఎక్స్‌టెన్షన్ ఇన్స్టాల్ చేయండి
### Performance Considerations
### పనితీరు పరుగు
- అనువదించిన ఫైల్స్ సంఖ్య ఎక్కువ (50+ భాషలు) కనుక పూర్తి క్లోన్‌ల పరిమాణం పెద్దది
- కేవలం కంటెంట్ మాత్రమే పని చేయాలనుకుంటే పొడవు 1 తో షలో క్లోన్ చేయండి: `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 ప్రాజెక్టులు
- వర్చువల్ ఎన్విరాన్‌మెంట్స్ ఉపయోగించాలి: `python -m venv venv`
- డిపెండెన్సీలని నవీకరించుకోండి
- GitHub టోకెన్లు కనీస అవసర అనుమతులతో ఉండాలి
- వర్చువల్ ఎన్విరాన్‌మెంట్లు ఉపయోగించండి: `python -m venv venv`
- డిపెండెన్సీలను తాజా వంతుగా ఉంచండి
- GitHub tokens కనీస అవసరమైన అనుమతులతోనే ఉండాలి
### GitHub Models Access
### GitHub Models యాక్సెస్
- GitHub మోడల్స్ కోసం వ్యక్తిగత యాక్సెస్ టోకెన్లు (PAT) అవసరం
- టోకెన్లను ఎన్విరాన్‌మెంట్ వేరియబుల్స్‌గా భద్రపరచాలి
- టోకెన్లను లేదా క్రెడెన్షియల్స్‌ను ఎప్పుడూ కమిట్ చేయకూడదు
- వ్యక్తిగత యాక్సెస్ టోకెన్లు (PAT) GitHub Models కోసం అవసరం
- టోకెన్లు పర్యావరణ వేరియబుల్స్ రూపంలో నిల్వ చేయాలి
- టోకెన్లు లేదా ప్రమాణపత్రాలను ఎప్పుడూ కమిట్ చేయకూడదు
## 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, డేటా సైన్స్, ML, IoT పరిధులు అందుబాటులో
- అభ్యాసకులకు [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) సిఫార్సులు
- అదనపు కోర్సులు: Generative AI, Data Science, ML, IoT పాఠ్యక్రమాలు అందుబాటులో
### Working with Specific Projects
### నిర్దిష్ట ప్రాజెక్టులతో పని చేయడం
ప్రత్యేక ప్రాజెక్టుల వివరణాత్మక సూచనల కోసం, ఈ README ఫైళ్లను చూడండి:
వివరమైన సూచనల కోసం ప్రతీ ప్రాజెక్ట్ 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 చాట్ అసిస్టెంట్ ప్రాజెక్ట్
- `7-bank-project/README.md` - బ్యాంకింగ్ అప్లికేషన్ (authentication తో)
- `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