# AGENTS.md

## Project Overview

ഇത് വെബ് വികസനത്തിന്റെ അടിസ്ഥാനങ്ങളെ തുടക്കക്കാരെ പഠിപ്പിക്കുന്നതിനുള്ള ഒരു വിദ്യാഭ്യാസ പാഠ്യപദ്ധതി റെപ്പോസിറ്ററിയാണ്. മൈക്രോസോഫ്റ്റ് ക്ലൗഡ് അഡ്വക്കേറ്റുകൾ വികസിപ്പിച്ചെടുത്ത 12 ആഴ്ചകളിലെ സമഗ്ര കോഴ്സ് ആണ് ഈ പാഠ്യപദ്ധതി, അതിൽ ജാവാസ്ക്രിപ്റ്റ്, CSS, HTML തുടങ്ങിയ വിഷയങ്ങളെക്കുറിച്ചുള്ള 24 പ്രായോഗിക പാഠങ്ങൾ ഉൾക്കൊള്ളുന്നു.

### Key Components

- **വിദ്യാഭ്യാസ ഉള്ളടക്കം**: പദ്ധതിപരമായി ക്രമീകരിച്ച 24 ഘടനാപരമായ പാഠങ്ങൾ
- **പ്രായോഗിക പ്രോജക്ടുകൾ**: Terrarium, ടൈപ്പിങ്ങ് ഗെയിം, ബ്രൗസർ എക്സ്‌ടൻഷൻ, സ്പേസ് ഗെയിം, ബാങ്കിംഗ് ആപ്പ്, കോഡ് എഡിറ്റർ, AI ചാറ്റ് അസിസ്റ്റന്റ്
- **ഇന്ററാക്ടീവ് ക്വിസുകൾ**: ഓരോത്തിലും 3 ചോദ്യങ്ങളുള്ള 48 ക്വിസുകൾ (പാഠം മുമ്പും ശേഷവും)
- **ബഹുഭാഷാ പിന്തുണ**: GitHub Actions ഉപയോഗിച്ച് 50+ ഭാഷകളിലേക്ക് സ്വಯമാറ്റം
- **ടെക്‌നോളജികൾ**: HTML, CSS, ജാവാസ്ക്രിപ്റ്റ്, Vue.js 3, Vite, Node.js, Express, Python (AI പ്രോജക്ടുകൾക്ക്)

### Architecture

- പാഠം അധിഷ്ഠിത ഘടനയോടെ വിദ്യാഭ്യാസ റെപ്പോസിറ്ററി
- ഓരോ പാഠ ഫോളഡറിൽ 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)

```bash
cd quiz-app
npm install
npm run dev        # ഡെവലപ്പ്മെന്റ് സർവർ തുടങ്ങിയ്ക്കുക
npm run build      # പ്രൊഡക്ഷനായി നിർമ്മിക്കുക
npm run lint       # ESLint ഓടിക്കൂ
```

### Bank Project API (Node.js + Express)

```bash
cd 7-bank-project/api
npm install
npm start          # എപി‌ഐ സര്‍വര്‍ ആരംഭിക്കുക
npm run lint       # ഇഎസ്എലിന്‍റ് ഓടിക്കുക
npm run format     # പ്രിസ്റ്റിയറോടെ ഫോര്‍മാറ്റ് ചെയ്യുക
```

### Browser Extension Projects

```bash
cd 5-browser-extension/solution
npm install
# ബ്രൗസര്‍-സവിശേഷമായ എക്‌സ്‌ടന്‍ഷന്‍ ലോഡിംഗ് നിർദ്ദേശങ്ങൾ പിന്തുടരുക
```

### Space Game Projects

```bash
cd 6-space-game/solution
npm install
# ബ്രൗസറിൽ index.html തുറക്കുക അല്ലെങ്കിൽ ലൈവ് സർവർ ഉപയോഗിക്കുക
```

### Chat Project (Python Backend)

```bash
cd 9-chat-project/solution/backend/python
pip install openai
# GITHUB_TOKEN പരിസ്ഥിതി സ്വഭാവിക ഘടകമായി സജ്ജമാക്കുക
python api.py
```

## Development Workflow

### For Content Contributors

1. നിങ്ങളുടെ GitHub അക്കൗണ്ടിൽ റെപ്പോസിറ്ററി **ഫോർക്ക് ചെയ്യുക**
2. നിങ്ങളുടെ ഫോർക്ക് ലൊക്കലായി **ക്ലോൺ ചെയ്യുക**
3. നിങ്ങളുടെ മാറ്റങ്ങൾക്കായി **പുതിയ ബ്രാഞ്ച് സൃഷ്ടിക്കുക**
4. പാഠ ഉള്ളടക്കം അല്ലെങ്കിൽ കോഡ് ഉദാഹരണങ്ങളിൽ മാറ്റങ്ങൾ വരുത്തുക
5. ബന്ധപ്പെട്ട പ്രോജക്ട് ഡയറക്ടറികളിൽ കോഡ് മാറ്റങ്ങൾ പരിശോധന നടത്തുക
6. കൺട്രിബ്യൂഷൻ മാർഗനിർദേശങ്ങൾ പാലിച്ച് പുൾ റിക്വസ്റ്റുകൾ സമർപ്പിക്കുക

### For Learners

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 Projects**:​អതിരേഷമുള്ള API ഡയറക്ടറികളിൽ `npm start` ഓടിക്കുക

## Testing Instructions

### Quiz App Testing

```bash
cd quiz-app
npm run lint       # കോഡ് സ്റ്റൈൽ പ്രശ്‌നങ്ങൾ പരിശോധിക്കുക
npm run build      # ബിൽഡ് വിജയിക്കുന്നത് സ്ഥിരീകരിക്കുക
```

### Bank API Testing

```bash
cd 7-bank-project/api
npm run lint       # കോഡ് സ്റ്റൈൽ പ്രശ്നങ്ങൾ പരിശോധിക്കുക
node server.js     # പിഴവുകൾ ഇല്ലാതെ സെർവർ തുടങ്ങുന്നത് സ്ഥിരീകരിക്കുക
```

### General Testing Approach

- ഇത് സമഗ്രമായ സ്വയംപരീക്ഷണ പരീക്ഷണങ്ങളില്ലാത്തൊരു വിദ്യാഭ്യാസ റെപ്പോസിറ്ററിയാണ്
- മാനുവൽ ടെസ്റ്റിംഗിന്റെ പ്രധാന ലക്ഷ്യം:
  - കോഡ് ഉദാഹരണങ്ങൾ പിശക് രഹിതമായ പ്രവർത്തനം
  - ഡോക്യുമെന്റേഷൻ ലിങ്കുകൾ ശരിയായ പ്രവർത്തനം
  - പ്രോജക്ട് ബിൽഡുകൾ പൂര്‍ണ്ണത
  - ഉദാഹരണങ്ങൾ മികച്ച അനുഭവരീതികൾ പാലിക്കുന്നു

### Pre-submission Checks

- package.json അടങ്ങിയ ഡയറക്ടറികളിൽ `npm run lint` ഓടിക്കുക
- മാർക്ക്ഡൗൺ ലിങ്കുകൾ സാധുവാണെന്ന് പരിശോധിക്കുക
- ബ്രൗസറിലോ Node.js-ലോ കോഡ് ഉദാഹരണങ്ങൾ പരീക്ഷിക്കുക
- വിവർത്തനങ്ങളുടെ ഘടന കൃത്യമായി നിലനിൽക്കുന്നു എന്ന് ഉറപ്പാക്കുക

## Code Style Guidelines

### JavaScript

- ആധുനിക ES6+ ലിപി ഉപയോഗിക്കുക
- പ്രോജക്ടുകളിൽ ലഭ്യമായ സാധാരണ ESLint കോൺഫിഗറേഷനുകൾ പാലിക്കുക
- വിദ്യാർത്ഥികൾക്ക് മനസ്സിലാക്കാൻ സാധിക്കുന്ന രീതിയിൽ നാമങ്ങൾ ഉപയോഗിക്കുക
- ആശയങ്ങൾ വിശദീകരിക്കുന്ന കുറിപ്പുകൾ ചേർക്കുക
- Prettier ഉപയോഗിച്ച് സജ്ജമാക്കിയ സ്ഥലങ്ങളിൽ ഫോർമാറ്റ് ചെയ്യുക

### HTML/CSS

- സേമാന്റിക് HTML5 ഘടകങ്ങൾ
- പ്രതികരണാത്മക ഡിസൈൻ സിദ്ധാന്തങ്ങൾ
- സ്പష్టం ക്ലാസ് നാമകരണ പാട്
- വിദ്യാർത്ഥികൾക്ക് സഹായകമായ CSS സാങ്കേതികത വിശദീകരിക്കുന്ന കുറിപ്പുകൾ

### Python

- PEP 8 ശൈലി മാർഗനിർദേശങ്ങൾ
- വ്യക്തവും പഠനാർത്ഥകവുമായ കോഡ് ഉദാഹരണങ്ങൾ
- പഠനത്തിന് സഹായകരമായ ടൈപ്പ് നിർദ്ദേശങ്ങൾ

### Markdown Documentation

- വ്യക്തമായ തലശ്രീനി ക്രമീകരണം
- ഭാഷ നിർദേശങ്ങളോടുകൂടിയ കോഡ് ബ്ലോക്കുകൾ
- അധിക വിഭവങ്ങളുടെ ലിങ്കുകൾ
- `images/` ഡയറക്ടറികളിൽ സ്‌ക്രീൻഷോട്ടുകളും ചിത്രങ്ങളും
- ആക്സസിബിലിറ്റിക്ക് ചിത്രം മാറ്റിനോട്ടുകൾ

### File Organization

- പാഠങ്ങൾ ക്രമീകരിച്ച സംഖ്യകൾ (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 ലോചനത്തിന് ക്രമീകരിച്ചിരിക്കുന്നു:

```bash
cd quiz-app
npm run build      # dist/ ഫോളדער് സൃഷ്ടിക്കുന്നു
# പ്രധാന ബ്രാഞ്ചിലേക്ക് പുഷ് ചെയ്യുമ്പോൾ GitHub Actions വർക്‌ഫ്ലോ ഉപയോഗിച്ച് വിന്യസിക്കുന്നു
```

Azure Static Web Apps ക്രമീകരണം:
- **ആപ്പ് സ്ഥലം**: `/quiz-app`
- **ഔട്ട്പുട്ട് സ്ഥലം**: `dist`
- **വർക്‌ഫ്ലോ**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`

### Documentation PDF Generation

```bash
npm install                    # docsify-to-pdf ഇൻസ്റ്റാൾ ചെയ്യുക
npm run convert               # ഡോക്‌സിൽ നിന്ന് PDF സൃഷ്‌ടിക്കുക
```

### Docsify Documentation

```bash
npm install -g docsify-cli    # ഡോക്സിഫൈ ആഗോളതലത്തിൽ ഇൻസ്റ്റാൾ ചെയ്യുക
docsify serve                 # localhost:3000-ൽ സർവ് ചെയ്യുക
```

### Project-specific Builds

ഓരോ പ്രോജക്ട് ഡയറക്ടറിയിലും വ്യത്യസ്ത ബിൽഡ് പ്രക്രിയകൾ ഉണ്ടായി കിടക്കാം:
- 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`

### Required Checks

പി ആർ സമർപ്പിക്കുന്നതിന് മുമ്പ്:

1. **കോഡ് ഗുണമേന്മ**:
   - ബാധകമായ പ്രോജക്ട് ഡയറക്ടറികളിൽ `npm run lint` ഓടിക്കുക
   - എല്ലാ ലിന്റ് പിശകുകളും മുന്നറിയിപ്പുകളും പരിഹരിക്കുക

2. **ബിൽഡ് പരിശോധന**:
   - ബാധകമുള്ള പക്ഷം `npm run build` ഓടിക്കുക
   - ബിൽഡ് പിശകുകൾ ഇല്ലെന്ന് ഉറപ്പാക്കുക

3. **ലിങ്ക് പരിശോധന**:
   - എല്ലാ മാർക്ക്ഡൗൺ ലിങ്കുകളും പരിശോധിക്കുക
   - ഇമേജ് റഫറൻസുകൾ ശരിയാണെന്ന് ഉറപ്പാക്കുക

4. **ഉള്ളടക്കം അവലോകനം**:
   - വൃത്തിപരിശോധനയും വ്യാകരണമികവ് പരിശോധിക്കൽ
   - കോഡ് ഉദാഹരണങ്ങൾ ശരിയായും വിദ്യാഭ്യാസപരവുമായുണ്ടെന്ന് ഉറപ്പാക്കുക
   - വിവർത്തനങ്ങൾ യഥാ അർത്ഥത്തെ നിലനിർ‍ത്തുന്നുണ്ടെന്ന് പരിശോധിക്കുക

### Contribution Requirements

- Microsoft CLA യുമായി അംഗീകരിക്കുക (ആദ്യ PR-ൽ ഓട്ടോമാറ്റിക് പരിശോധന)
- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) പാലിക്കുക
- വിശദമായ മാർഗനിർദേശങ്ങൾക്ക് [CONTRIBUTING.md](./CONTRIBUTING.md) നോക്കുക
- ആവശ്യമായ പക്ഷം പുൾ റിക്ക്വസ്റ്റ് വിവരണത്തിൽ ഇഷ്യൂ നമ്പറുകൾ ഉൾപ്പെടുത്തുക

### Review Process

- PR കൾ മെയിന്റെയ്‌നർമാർക്കും സമൂഹത്തിനും റിവ്യൂ ചെയ്യപ്പെടും
- വിദ്യാഭ്യാസ വ്യക്തത മുൻഗണനയാണ്
- കോഡ് ഉദാഹരണങ്ങൾ നിലവിലുള്ള മികച്ച രീതികൾ പാലിക്കണം
- വിവർത്തനങ്ങൾ കൃത്യതയോടെ സംസ്ക്കാരപരമായ അനുയോജ്യതയോടെ പരിശോധിക്കും

## Translation System

### Automated Translation

- GitHub Actions ഉപയോഗിച്ച് co-op-translator വർക്ഫ്ലോ ഉപയോഗിക്കുന്നു
- 50+ ഭാഷകളിലേക്ക് ഓട്ടോമാറ്റിക് വിവർത്തനം നൽകുന്നു
- പ്രധാനം ഡയറക്ടറികളിലുള്ള സ്രോത് ഫയലുകൾ
- വിവർത്തന ഫയലുകൾ `translations/{language-code}/` ഡയറക്ടറിയിലാണ്

### Adding Manual Translation Improvements

1. `translations/{language-code}/`യിൽ സ്ഥിതിചെയ്യുന്ന ഫയൽ കണ്ടെത്തുക
2. ഘടന നിലനിർത്തികൊണ്ട് പരിഷ്ക്കാരങ്ങൾ ചെയ്യുക
3. കോഡ് ഉദാഹരണങ്ങൾ പ്രവർത്തനക്ഷമമാണെന്ന് ഉറപ്പാക്കുക
4. ഏതെങ്കിലും പ്രാദേശിക ക്വിസ് ഉള്ളടക്കം പരീക്ഷിക്കുക

### Translation Metadata

വിവർത്തന ഫയലുകളിൽ മെറ്റാഡേറ്റ ഹedersറുകൾ ഉൾപ്പെടുന്നു:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
{
  "original_hash": "...",
  "translation_date": "...",
  "source_file": "...",
  "language_code": "..."
}
-->
```

## Debugging and Troubleshooting

### Common Issues

**Quiz app fails to start**:
- Node.js പതിപ്പ് പരിശോധിക്കുക (v14+ ശുപാർശ)
- `node_modules`യും `package-lock.json`യും ഇല്ലാതാക്കി വീണ്ടും `npm install` ഓടിക്കുക
- പോർട്ട് കോൺഫ്ലിക്റ്റുകൾ പരിശോധിക്കുക (ഡീഫോൾട്ട്: Vite വിഷയം 5173)

**API server won't start**:
- Node.js പതിപ്പ് കുറഞ്ഞത് node >=10 ആണെന്ന് ഉറപ്പാക്കുക
- പോർട്ട് ഉപയോഗത്തിലാണ് എന്ന് പരിശോധിക്കുക
- എല്ലാം ഡെപൻഡൻസികളും `npm install` വഴി ഇൻസ്റ്റാൾ ചെയ്തുണ്ടെന്ന് ഉറപ്പാക്കുക

**Browser extension won't load**:
- manifest.json ശരിയായ ഫോർമാറ്റിൽ ആണെന്ന് പരിശോധിക്കുക
- ബ്രൗസർ കോൺസോൾ പിശകുകൾ കാണുക
- ബ്രൗസറിനനുസരിച്ച് എക്സ്‌ടൻഷൻ ഇൻസ്റ്റലേഷൻ മാർഗനിർദേശങ്ങൾ പാലിക്കുക

**Python chat project issues**:
- OpenAI പാക്കേജ് ഇൻസ്റ്റാൾ ചെയ്തിട്ടുണ്ടോ പരിശോധിക്കുക: `pip install openai`
- GITHUB_TOKEN എൻവയോണ്മെന്റ് വേരിയബിൾ സജ്ജമാണെന്ന് ഉറപ്പാക്കുക
- GitHub മോഡൽസ് ആക്സസ് അനുമതികൾ പരിശോധിക്കുക

**Docsify not serving docs**:
- docsify-cli ഗ്ലോബലായി ഇൻസ്റ്റാൾ ചെയ്യുക: `npm install -g docsify-cli`
- റെപ്പോസിറ്ററി റൂട്ടിൽ നിന്നു ഓടിക്കുക
- `docs/_sidebar.md` നിലവിലുണ്ടെന്ന് ഉറപ്പാക്കുക

### Development Environment Tips

- HTML പ്രോജക്ടുകൾക്കുള്ള VS Code Live Server എക്സ്റ്റെൻഷൻ ഉപയോഗിക്കുക
- ഏകാസംബന്ധിതമായ ഫോർമാറ്റ്‌ക്കായി ESLint, Prettier എക്സ്റ്റൻഷനുകൾ ഇൻസ്റ്റാൾ ചെയ്യുക
- JavaScript ഡീബഗ് ചെയ്യാൻ ബ്രൗസർ ഡെവ്ടൂൾസ് ഉപയോഗിക്കുക
- Vue പ്രോജക്ടുകൾക്കായി Vue DevTools ബ്രൗസർ എക്സ്‌ടൻഷൻ ഇൻസ്റ്റാൾ ചെയ്യുക

### Performance Considerations

- 50+ ഭാഷകളിലുള്ള വിവർത്തിത ഫയലുകളുടെ എണ്ണം വലിയതാണ്, ഫുൾ ക്ലോണുകൾ വലിയതാണ്
- ഉള്ളടക്കത്തിൽ മാത്രം പ്രവർത്തിക്കുന്നവർക്ക് ഷാലോ ക്ലോൺ ഉപയോഗിക്കുക: `git clone --depth 1`
- ഇംഗ്ലീഷ് ഉള്ളടക്കത്തിൽ നടത്തിയപ്പോൾ വിവർത്തനങ്ങൾ തിരയൽ പുറത്താകുന്നതായി ഒഴിവാക്കുക
- ആദ്യ ഓടിയിൽ ബിൽഡ് പ്രക്രിയകൾ (npm install, Vite build) നിത്യം സാധാരണയായി ക്ഷീണാകും

## Security Considerations

### Environment Variables

- API കീകൾ രെപ്പോസിറ്ററിയിൽ ഒരിക്കലും കമ്മിറ്റ് ചെയ്യരുത്
- `.env` ഫയലുകൾ ഉപയോഗിക്കുക (ഇതെല്ലാം `.gitignore`-ലുണ്ട്)
- ആവശ്യമായ എൻ‌വയോൺമെന്റ് വേരിയബിളുകൾ പ്രോജക്ട് READMEs-ൽ രേഖപ്പെടുത്തുക

### Python Projects

- വെർച്ച്വൽ എൻ‌വയോൺമെന്റ് ഉപയോഗിക്കുക: `python -m venv venv`
- ഡെപൻഡൻസികൾ അപ്ഡേറ്റ് ചെയ്ത് വയ്ക്കുക
- GitHub ടോക്കണുകൾക്ക് കുറഞ്ഞ ആവശ്യമായ അനുമതികൾ മാത്രം നൽകുക

### GitHub Models Access

- GitHub മോഡലുകളിലേക്കുള്ള വ്യക്തിഗത ആക്‌സസ് ടോക്കണുകൾ ആവശ്യമാണ് (PAT)
- ടോക്കണുകൾ എൻ‌വയോൺമെന്റ് വേരിയബിളുകളായി സൂക്ഷിക്കുക
- ടോക്കണുകൾ അല്ലെങ്കിൽ ക്രെഡൻഷ്യലുകൾ ഒരിക്കലും കമ്മിറ്റ് ചെയ്യരുത്

## Additional Notes

### Target Audience

- വെബ് വികസനത്തിൽ പൊതുവായി തുടങ്ങുന്നവർ
- വിദ്യാർത്ഥികളും സവാൽ പഠനക്കാരും
- ക്ലാസറूमിൽ പാഠ്യപദ്ധതി ഉപയോഗിക്കുന്ന അധ്യാപകർ
- പ്രവേശന യോഗ്യതയും നേതൃത്വപരവും ഉള്ള ഉള്ളടക്കം

### Educational Philosophy

- പദ്ധതിപരമായ പഠന സമീപനം
- സ്ഥിരം അറിവ് പരിശോധിക്കൽ (ക്വിസുകൾ)
- പ്രായോഗിക കോഡിംഗ് അഭ്യാസങ്ങൾ
- യാഥാർത്ഥ്യ ലോക ഉദാത്തങ്ങൾ
- ഫ്രെയിംവർക്കുകളുടെ മുമ്പ് അടിസ്ഥാന സിദ്ധാന്തങ്ങൾ

### Repository Maintenance

- സജീവമായ പഠനക്കാരുടെയും പങ്കാളികളുടെയും സമൂഹം
- ഡെപെൻഡൻസികളും ഉള്ളടക്കവും নিয়മിതമായി നവീകരിക്കുന്നു
- മെയിന്റെയ്‌നർമാരും ചര്‍ച്ചകളും ശ്രദ്ധിക്കുന്നു
- 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 പാഠ്യങ്ങള്

### Working with Specific Projects

തനതു പ്രോജക്ടുകൾക്കുള്ള വിശദമായ നിർദ്ദേശങ്ങൾക്കായി വായിക്കുക:
- `quiz-app/README.md` - Vue 3 ക്യൂvis് ആപ്പ്
- `7-bank-project/README.md` - ബാൻക് ആപ്പ് ഓത്തന്റിക്കേഷൻ സെറ്റ് ചെയ്യപ്പെട്ടത്
- `5-browser-extension/README.md` - ബ്രൗസർ എക്സ്റ്റെൻഷൻ വികസനം
- `6-space-game/README.md` - കാൻവാസ് അടിസ്ഥാനമായ ഗെയിം വികസനം
- `9-chat-project/README.md` - AI ചാറ്റ് അസിസ്റ്റന്റ് പ്രോജക്ട്

### Monorepo Structure

പരമ്പരാഗത മോനോറിപ്പോ അല്ലെങ്കിലും, ഈ റെപ്പോസിറ്ററി പല സ്വതന്ത്ര പ്രോജക്ടുകൾ ഉൾക്കൊള്ളുന്നു:
- ഓരോ പാഠവും സ്വതന്ത്രമാണ്
- പ്രോജക്ടുകൾ പരസ്പരം ഡെപൻഡൻസികൾ പങ്കിടുന്നില്ല
- മറ്റുള്ളവരെ ബാധിക്കാതെ വ്യക്തിഗത പ്രോജക്ടുകളിൽ പ്രവർത്തിക്കുക
- മുഴുവൻ പാഠ്യപദ്ധതി അനുഭവത്തിനായി മുഴുവൻ റെപ്പോ ക്ലോൺ ചെയ്യുക

---

<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**അസൂയാനിർദ്ദേശം**:  
ഈ രേഖ AI വിവർത്തനം സേവനം [Co-op Translator](https://github.com/Azure/co-op-translator) ഉപയോഗിച്ച് വിവർത്തനം ചെയ്‌തതാണ്. ഞങ്ങൾ പരമാവധി ശരിക്കും ശ്രമിക്കുന്നുവെങ്കിലും, സ്വയംക്രമിത വിവർത്തനങ്ങളിൽ പിഴവുകളോ അസാധ്യതകളോ ഉണ്ടാകാൻ സാധ്യതയുള്ളതാണ്. അതിനാൽ, ദയവായി ശ്രദ്ധിക്കേണ്ടത്, ഈ രേഖയുടെ മുമ്ബ് ഉള്ള ഭാഷയിലുള്ള യുഗ്മം പ്രാമാണിക സ്രോതസ്സായി കണക്കാക്കണം. നിർണായക വിവരങ്ങൾക്ക് പ്രൊഫഷണൽ മനുഷ്യ വിവർത്തനം ശിപാർശ ചെയ്യുന്നു. ഈ വിവർത്തനത്തിന്റെ ഉപയോഗത്തെത്തുടർന്ന് ഉണ്ടാകുന്ന ഏതെങ്കിലും തെറ്റിദ്ധാരണകൾക്കും അർത്ഥവിമർശങ്ങൾക്കും ഞങ്ങൾ ഉത്തരവാദികളല്ല.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->