# AGENTS.md

## Project Overview

ഇത് ആരംഭികൾക്ക് വെബ് ഡെവലപ്‌മെന്റ് അടിസ്ഥാനങ്ങൾ പഠിപ്പിക്കാൻ നിർമ്മിച്ച ഒരു വിദ്യാഭ്യാസ പാഠ്യപദ്ധതി റിപ്പോസിറ്ററിയാണ്. മൈക്രോസോഫ്റ്റ് ക്ലൗഡ് അവോകേറ്റേഴ്സ് വികസിപ്പിച്ചുള്ള ഈ പാഠ്യപരമായ കോഴ്സ് 24 ഹാൻഡ്‌സ്-ഓൺ പാഠങ്ങൾ ഉൾക്കൊണ്ട് ജാവാസ്ക്രിപ്റ്റ്, CSS, HTML എന്നിവ അടങ്ങിയ ഏകദേശം 12 ആഴ്ചകൾക്കുള്ള പാഠ്യപദ്ധതിയാണ്.

### Key Components

- **വിദ്യാഭ്യാസ ഉള്ളടക്കം**: പ്രോജക്ട് അധിഷ്ഠിത മഡ്യൂളുകളായി ക്രമീകരിച്ച 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 ആയി ലഭ്യമാകുന്നു

## 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       # 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 തുറക്കുക അല്ലെങ്കിൽ ലൈവ് സർവർ ഉപയോഗിക്കുക
```

### 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. റിപ്പോസിറ്ററി 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 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/` ഡയറക്ടറികളിലുള്ള സ്ക്രീൻഷോട്ടുകളും ചിത്രങ്ങളും
- ആക്സസിബിലിറ്റിക്ക് വേണ്ടി ചിത്രങ്ങളുടെ Alt ടെക്‌സ്‌റ്റുകൾ

### 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 ആഗോളമായി ഇൻസ്റ്റാൾ ചെയ്യുക
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

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

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) കാണുക
- PR വിവരണത്തിൽ ബന്ധപ്പെട്ട(issue) നമ്പറുകൾ ഉൾപ്പെടുത്തുക (ഉണ്ടെങ്കിൽ)

### 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

പരിഭാഷ ഫയലുകൾ metadata ഹെഡറും ഉൾക്കൊള്ളുന്നു:
```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 Models ആക്‌സസ് അനുമതികൾ പരിശോധിക്കുക

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

### Development Environment Tips

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

### Performance Considerations

- 50+ ഭാഷകളിൽ അനേകം പരിഭാഷാ ഫയലുകൾ ഉള്ളതിനാൽ പൂർണ്ണ ക്ലോണുകൾ വലുതാണ്
- ഉള്ളടക്കത്തിൽ മാത്രം ജോലി ചെയ്‌ക്കുമ്പോൾ `git clone --depth 1` പോലുള്ള ഷാലോ ക്ലോണിംഗ് ഉപയോഗിക്കുക
- ഇംഗ്ലീഷ് ഉള്ളടക്കത്തിൽ ജോലി ചെയ്‌തുകൊണ്ടിരിക്കുമ്പോൾ പരിഭാഷകളെ തിരച്ചിൽ നിന്നും ഒഴിവാക്കുക
- ആദ്യ ഓടgurila npm install, Vite build തുടങ്ങിയവയിൽ ബിൽഡ് പ്രക്രിയകൾ മന്ദഗതിയിലുള്ളതാണ്

## Security Considerations

### Environment Variables

- API കീകൾ റിപ്പോസിറ്ററിയിലേക്ക് കമിറ്റ് ചെയ്യരുത്
- `.env` ഫയലുകൾ ഉപയോഗിക്കുക (ഇതിന്റെ സാഹചര്യത്തിൽ `.gitignore` നല്കപ്പെട്ടിരിക്കുന്നു)
- ആവശ്യമായ അന്തരീക്ഷ변数കൾ പ്രോജക്ട് README-കളിൽ രേഖപ്പെടുത്തുക

### 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

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

### Monorepo Structure

പാരമ്പര്യമായ മൊണോറെപ്പോ അല്ലെങ്കിലും, ഈ റിപ്പോസിറ്ററിയിൽ പല സ്വതന്ത്ര പ്രോജക്ടുകൾ അടങ്ങുന്നു:
- ഓരോ പാഠവും സ്വയം സാങ്കേതികമായി പൂർണ്ണമാണ്
- പ്രോജക്ടുകൾ ആശ്രിതങ്ങൾ പങ്കുവയ്ക്കുന്നില്ല
- വ്യത്യസ്ത പ്രോജക്ടുകളിൽ പരസ്പരം പ്രഭാവം ഇല്ലാതെ ജോലി ചെയ്യാം
- പൂർണ പാഠ്യകൂട്ടാനുഭവത്തിനായി മുഴുവൻ റിപ്പോസിറ്ററി ക്ലോൺ ചെയ്യുക

---

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