# AGENTS.md

## പ്രോജക്ട് അവലോകനം

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

### പ്രധാന ഘടകങ്ങൾ

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

### ആർക്കിടെക്ചർ

- പാഠ്യ അടിസ്ഥാനമുള്ള വിദ്യാഭ്യാസ സംഭരം  
- ഓരോ പാഠ ഫോളഡറിലും README, കോഡ് ഉദാഹരണങ്ങൾ, പരിഹാരങ്ങൾ  
- വേറിട്ട ഡയറക്ടറികളിൽ സ്റ്റാൻഡ്എലോൺ പ്രോജക്ടുകൾ (quiz-app, വിവിധ പാഠ പ്രോജക്ടുകൾ)  
- GitHub ആക്ഷനുകൾ ഉപയോഗിക്കുന്ന വിവർത്തന സംവിധാനം (co-op-translator)  
- ഡോക്യുമെന്റേഷൻ Docsify വഴി ലഭ്യമാണ്, PDF ആയി ലഭ്യമായിരിക്കും  

## സെറ്റപ് കമാൻഡുകൾ

ഈ സംഭരം പ്രാഥമികമായി വിദ്യാഭ്യാസ ഉള്ളടക്കം ഉപയോഗിക്കലിനാണ്. പ്രത്യേക പ്രോജക്ടുകളുമായി ജോലി ചെയ്യാനായി:

### മുഖ്യ സംഭരം സെറ്റപ്പ്

```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners
```

### ക്വിസ് ആപ്പ് സെറ്റപ്പ് (Vue 3 + Vite)

```bash
cd quiz-app
npm install
npm run dev        # വികസന സർവർ ആരംഭിക്കുക
npm run build      # ഉത്പാദനത്തിനായി നിർമാണം
npm run lint       # ESLint പ്രവർത്തിപ്പിക്കുക
```

### ബാങ്ക് പ്രോജക്ട് API (Node.js + Express)

```bash
cd 7-bank-project/api
npm install
npm start          # API സർവർ ആരംഭിക്കുക
npm run lint       # ESLint ഓടി
npm run format     # Prettier ഉപയോഗിച്ച് ഫോർമാറ്റ് ചെയ്യുക
```

### ബ്രൗസർ എക്സ്റ്റൻഷൻ പ്രോജക്ടുകൾ

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

### സ്പേസ് ഗെയിം പ്രോജക്ടുകൾ

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

### ചാറ്റ് പ്രോജക്ട് (Python ബാക്ക്‌എൻഡ്)

```bash
cd 9-chat-project/solution/backend/python
pip install openai
# GITHUB_TOKEN പരിസ്ഥിതി ചുരുക്കുവചനം സജ്ജീകരിക്കുക
python api.py
```

## ഡെവലപ്പ്മെന്റ് വർക്ഫ്ലോ

### ഉള്ളടക്കം സംഭാവകരും

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

### പഠിയ്ക്കുന്നവർക്ക്

1. Fork ചെയ്യുക അല്ലെങ്കിൽ റിപ്പോസിറ്ററി clone ചെയ്യുക  
2. പാഠ ഡയറക്ടറികൾ പര്യവേക്ഷണം ചെയ്യുക  
3. ഓരോ പാഠത്തിന്റെയും README ഫയലുകൾ വായിക്കുക  
4. https://ff-quizzes.netlify.app/web/ ൽ മുൻകൂറുള്ള ക്വിസുകൾ പൂർത്തിയാക്കുക  
5. പാഠ ഫോളഡറിലെ കോഡ് ഉദാഹരണങ്ങളിൽ പ്രവർത്തിക്കുക  
6. അസൈൻമെന്റുകളും ചലഞ്ചുകളും പൂർത്തിയാക്കുക  
7. പാഠത്തിനു ശേഷം ക്വിസുകൾ എടുക്കുക  

### ലൈവ് ഡെവലപ്പ്മെന്റ്

- **ഡോക്യുമെന്റ്**: റൂട്ടിൽ `docsify serve` ഓടിക്കുക (പോർട്ട് 3000)  
- **ക്വിസ് ആപ്പ്**: `quiz-app` ഡയറക്ടറിയിൽ `npm run dev` റൺ ചെയ്യുക  
- **പ്രോജക്ടുകൾ**: HTML പ്രോജക്ടുകൾക്കായി VS Code ലൈവ് സെർവർ വിപുലീകരണം ഉപയോഗിക്കുക  
- **API പ്രോജക്ടുകൾ**: അനുയായിയായ API ഡയറക്ടറികളിൽ `npm start` ഓടിക്കുക  

## ടസ്റ്റിംഗ് നിർദ്ദേശങ്ങൾ

### ക്വിസ് ആപ്പ് ടെസ്റ്റിംഗ്

```bash
cd quiz-app
npm run lint       # കോഡ് സ്റ്റൈൽ പ്രശ്നങ്ങൾ പരിശോധിക്കുക
npm run build      # ബിൽഡ് വിജയകരമാണെന്ന് ഉറപ്പാക്കുക
```

### ബാങ്ക് API ടെസ്റ്റിംഗ്

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

### പൊതുവായ ടെസ്റ്റിംഗ് സമീപനം

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

### മുൻസമർപ്പണ പരിശോധനകൾ

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

## കോഡ് സ്റ്റൈൽ മാർഗനിർദ്ദേശങ്ങൾ

### ജാവാസ്ക്രിപ്റ്റ്

- ആധുനിക ES6+ സിന്താക്‌സ് ഉപയോഗിക്കുക  
- പ്രോജക്ടുകളിൽ നൽകിയ സ്റ്റാൻഡേർഡ് ESLint കോൺഫിഗറേഷൻ പിന്തുടരുക  
- ശാസ്ത്രീയ പഠനത്തിന് പ്രസക്തമായ വേരിയബിൾ, ഫംഗ്ഷൻ നാമങ്ങൾ ഉപയോഗിക്കുക  
- പഠിക്കുന്നവർക്കായി ആശയങ്ങൾ വിശദീകരിക്കുന്ന കമന്റുകൾ ചേർക്കുക  
- നിർദ്ദിഷ്ട Prettier ഫോർമാറ്റർ ഉപയോഗിക്കുക  

### HTML/CSS

- സെമാന്റിക് HTML5 ഘടകങ്ങൾ  
- റെസ്പോൺസീവ് ഡിസൈൻ സിദ്ധാന്തങ്ങൾ  
- വ്യക്തമായ ക്ലാസ് നാമം നൽകൽ  
- CSS സാങ്കേതികവിദ്യകൾ വിശദീകരിക്കുന്ന കമന്റുകൾ  

### Python

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

### മാർക്ക്ഡൗൺ ഡോക്യുമെന്റേഷൻ

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

### ഫയൽ സംഘടന

- പാഠങ്ങൾ ക്രമത്തിൽ നമ്പർ ചെയ്തിരിക്കുന്നു (1-getting-started-lessons, 2-js-basics മുതലായവ)  
- ഓരോ പ്രോജക്ടിനും `solution/` ഫോളഡറും, ഒരുപാട് കേസുകളിൽ `start/` അല്ലെങ്കിൽ `your-work/` ഫോളഡറുകളും  
- പാഠ-പ്രത്യേക `images/` ഫോൾഡറുകളിൽ ചിത്രങ്ങൾ സൂക്ഷിക്കുക  
- `translations/{language-code}/` ഘടനയിൽ വിവർത്തനങ്ങൾ   

## കെട്ടിടം, വിനിയോഗം

### ക്വിസ് ആപ്പ് വിനിയോഗം (Azure Static Web Apps)

കോ quiz-app-ന് Azure Static Web Apps വിനിയോഗം കോൺഫിഗർ ചെയ്തിരിക്കുന്നു:

```bash
cd quiz-app
npm run build      # dist/ ഫോൾഡർ സൃഷ്ടിക്കുന്നു
# main ൽ push ചെയ്യുമ്പോൾ GitHub Actions workflow വഴി വിന്യസിക്കുന്നു
```

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

### ഡോക്യുമെന്റേഷൻ PDF സൃഷ്ടി

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

### Docsify ഡോക്യുമെന്റേഷൻ

```bash
npm install -g docsify-cli    # ഡോക്‌സ്ഫൈ ഗ്ലോബലായി ഇൻസ്റ്റാൾ ചെയ്യുക
docsify serve                 # ലോക്കൽഹോസ്റ്റിൽ 3000ിനു സർവ് ചെയ്യുക
```

### പ്രോജക്ട് പ്രത്യേകമായ കെട്ടിടങ്ങൾ

ഓരോ പ്രോജക്ട് ഡയറക്ടറിയിലും തികച്ചും വേറിട്ട കെട്ടിട പ്രക്രിയ ഉണ്ടാകാം:  
- Vue പ്രോജക്ടുകൾ: `npm run build` പ്രൊഡക്ഷൻ ബണ്ടിലുകൾ സൃഷ്ടിക്കുന്നു  
- സ്റ്റാറ്റിക് പ്രോജക്ടുകൾ: കെട്ടിടം ഇല്ലാതെ ഉടൻ സർവ് ചെയ്യുന്നു  

## പുൾ റിക്ക്വസ്റ്റ് മാർഗനിർദ്ദേശങ്ങൾ

### തലക്കെട്ട് ഫോർമാറ്റ്

മാറ്റത്തിന്റെ മേഖല വ്യക്തമാക്കുന്ന ശുദ്ധമായ ശീർഷകങ്ങൾ ഉപയോഗിക്കുക:  
- `[Quiz-app] ലെഷൻ X ന് പുതിയ ക്വിസ് ചേർക്കുക`  
- `[Lesson-3] Terrarium പ്രോജക്ടിൽ ടൈपो നിഷേധിക്കുക`  
- `[Translation] ലെഷൻ 5 ന് സ്പാൻസിഷ് വിവർത്തനം ചേർക്കുക`  
- `[Docs] സെറ്റപ്പ് നിർദ്ദേശങ്ങൾ അപ്ഡേറ്റ് ചെയ്യുക`  

### ആവശ്യമായ പരിശോധനകൾ

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

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

2. **കെട്ടിട പരിശോധന**:  
   - പ്രയോഗിക്കാവുന്നുവെങ്കിൽ `npm run build` റൺ ചെയ്യുക  
   - കോഡ് പിഴവുകൾ ഇല്ലെന്ന് ഉറപ്പാക്കുക  

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

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

### സംഭാവക ആവശ്യകതകൾ

- മൈക്രോസോഫ്റ്റ് CLA സമ്മതിക്കുക (ആദ്യ PR ന് ഓട്ടോമാറ്റിക് പരിശോധന)  
- [മൈക്രോസോഫ്റ്റ് ഓപ്പൺ സോഴ്‌സ് കോഡ് ഓഫ് കംഡക്ട്](https://opensource.microsoft.com/codeofconduct/) പാലിക്കുക  
- വിശദ മാർഗനിർദ്ദേശങ്ങൾക്ക് [CONTRIBUTING.md](./CONTRIBUTING.md) കാണുക  
- PR വിവരണത്തിൽ കാര്യങ്ങൾ സംബന്ധിച്ച(issue-numbers) ഉദ്ധരിക്കുക  

### അവലോകന പ്രക്രിയ

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

## വിവർത്തന സംവിധാനം

### ഓട്ടോമാറ്റഡ് വിവർത്തനം

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

### മാനുവൽ വിവർത്തന മെച്ചപ്പെടുത്തലുകൾ ചേർക്കൽ

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

### വിവർത്തന മെറ്റാഡാറ്റ

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

## ഡീബഗിങ്ങും പ്രശ്നപരിഹാരവും

### സാധാരണ പ്രശ്നങ്ങൾ

**ക്വിസ് ആപ്പ് തുടങ്ങുന്നതിൽ പരാജയം**:  
- Node.js പതിപ്പ് പരിശോധിക്കുക (v14+ ശുപാർശ)  
- `node_modules` , `package-lock.json` ഇല്ലാതാക്കി പുനഃസ്ഥാപിക്കുക `npm install`  
- പോർട്ട് കോഴുത്തുകൾ പരിശോധിക്കുക (ഡിഫോൾട്ട്: Vite പോർട്ട് 5173)  

**API സെർവർ തുടങ്ങാനില്ല**:  
- കുറഞ്ഞ Node.js പതിപ്പ് ഉറപ്പാക്കുക (node >=10)  
- പോർട്ട് ഉപയോഗത്തിൽ ആണോ എന്ന് പരിശോധിക്കുക  
- എല്ലാ ആശ്രിതങ്ങൾ `npm install` ഉപയോഗിച്ച് ഇൻസ്റ്റാൾ ചെയ്തിട്ടുണ്ടെന്ന് ഉറപ്പാക്കുക  

**ബ്രൗസർ എക്സ്റ്റൻഷൻ ലോഡ് ആവുന്നില്ല**:  
- manifest.json ശരിയായി ഫോർമാറ്റ് ചെയ്‌തിട്ടുണ്ടോ എന്ന് പരിശോധിക്കുക  
- ബ്രൗസർ കോൺസോൾ പിശകുകൾ കാണുക  
- ബ്രൗസർ-സ്പെസിഫിക് എക്സ്റ്റൻഷൻ ഇൻസ്റ്റലേഷൻ നിർദ്ദേശങ്ങൾ പാലിക്കുക  

**Python ചാറ്റ് പ്രോജക്ട് പ്രശ്നങ്ങൾ**:  
- OpenAI പാക്കേജ് ഇൻസ്റ്റാൾ ചെയ്തിട്ടുണ്ടെങ്കിൽ: `pip install openai`  
- GITHUB_TOKEN എൻവയ്റൺമെന്റ് വെരിയബിൾ സജ്ജമാണെന്ന് സ്ഥിരീകരിക്കുക  
- GitHub മോഡലുകളുടെ ആക്‌സസ് അനുമതി പരിശോധിക്കുക  

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

### ഡെവലപ്മെന്റ് ആൻvirons

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

### പെർഫോർമൻസ് പരിഗണനകൾ

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

## സുരക്ഷാ പരിഗണനകൾ

### എൻവയ(amount)ന്റ variables

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

### Python പ്രോജക്ടുകൾ

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

### GitHub മോഡലുകൾ ആക്‌സസ്

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

## അധിക കുറിപ്പുകൾ

### ലക്ഷ്യ പ്രേക്ഷകർ

- വെബ് ഡെവലപ്പ്മെന്റിൽ പുത്തൻ തുടക്കം കുറിക്കുന്നവർ  
- വിദ്യാർത്ഥികളും സ്വയം പഠിക്കുന്നവരും  
- ക്ലാസുകളിൽ പാഠ്യകാര്യം ഉപയോഗിക്കുന്ന അധ്യാപകർ  
- ആക്‌സസിബിലിറ്റിക്കും ക്രമികമായ നൈപുണ്യ വികസനത്തിനും രൂപപ്പെടുത്തിയ ഉള്ളടക്കം  

### വിദ്യാഭ്യാസ തത്വചിന്തനം

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

### സംരക്ഷണ പ്രവർത്തനം

- പഠിയ്ക്കുന്നവരുടെ, സംഭാവകരുടെ സജീവ സമൂഹം  
- ആശ്രിതങ്ങളും ഉള്ളടക്കവും സ്ഥിരം അപ്ഡേറ്റുകൾ  
- നിലനിൽപ്പുകാർ പ്രശ്നങ്ങൾക്കും ചർച്ചകൾക്കും ശ്രദ്ധ നൽകുന്നു  
- വിവർത്തന അപ്ഡേറ്റുകൾ GitHub ആക്ഷനുകൾ വഴി ഓട്ടോമാറ്റിക് ചെയ്യുന്നു  

### ബന്ധപ്പെട്ട വിഭവങ്ങൾ

- [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 പാഠ്യപദ്ധതികൾ ലഭ്യമാണ്  

### പ്രത്യേക പ്രോജക്ടുകളുമായി ജോലി ചെയ്യൽ

വിവരങ്ങൾക്ക് ഓരോ പ്രോജക്റ്റിൻറെ 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 ചാറ്റ് അസിസ്റ്റന്റ്  

### മൊണൊറെപോ ഘടന

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

---

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