# AGENTS.md

## ਪ੍ਰੋਜੈਕਟ ਓਵਰਵਿਊ

ਇਹ शुरुआਤੀ ਵੈੱਬ ਵਿੱਕਾਸ਼ ਮੂਲਾਂਕਣ ਸਿਖਾਉਣ ਲਈ ਇੱਕ ਸਿੱਖਣਯੋਗ ਸਿਲੇਬਸ ਰਿਪੋਜ਼ਿਟਰੀ ਹੈ। ਇਹ ਸਿਲੇਬਸ ਮਾਈਕ੍ਰੋਸਾਫਟ ਕਲਾਉਡ ਅਡਵੋਕੇਟਸ ਵੱਲੋਂ ਵਿਕਸੀਤ ਇੱਕ ਸਮੱਗਰੀਤ 12 ਹਫ਼ਤਿਆਂ ਦਾ ਕੋਰਸ ਹੈ, ਜਿਸ ਵਿੱਚ JavaScript, CSS, ਅਤੇ HTML ਦੀਆਂ 24 ਪ੍ਰਯੋਗਸ਼ੀਲ ਲੈਸਨਾਂ ਸ਼ਾਮਲ ਹਨ।

### ਮੁੱਖ ਘਟਕ

- **ਸਿੱਖਣਯੋਗ ਸਮੱਗਰੀ**: ਪ੍ਰੋਜੈਕਟ-ਆਧਾਰਿਤ ਮੋਡਿਊਲਾਂ ਵਿੱਚ ਵਿਵਸਥਿਤ 24 ਪਾਠ
- **ਪ੍ਰਯੋਗਸ਼ੀਲ ਪ੍ਰੋਜੈਕਟ**: ਟੈਰੀਆਰਿਯਮ, ਟਾਈਪਿੰਗ ਗੇਮ, ਬਰਾਊਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ, ਸਪੇਸ ਗੇਮ, ਬੈਂਕਿੰਗ ਐਪ, ਕੋਡ ਐਡੀਟਰ, ਅਤੇ AI ਚੈਟ ਅਸਿਸਟੈਂਟ
- **ਇੰਟਰਐਕਟਿਵ ਕਵਿਜ਼**: 48 ਕਵਿਜ਼, ਹਰ ਇੱਕ ਵਿੱਚ 3 ਸਵਾਲ (ਪਹਿਲਾਂ/ਬਾਅਦ ਲੈਸਨ ਮੁਲਾਂਕਣ)
- **ਬਹੁ-ਭਾਸ਼ਾ ਸਹਾਇਤਾ**: GitHub Actions ਦੁਆਰਾ 50+ ਭਾਸ਼ਾਵਾਂ ਵਿੱਚ ਆਟੋਮੈਟਿਕ ਅਨੁਵਾਦ
- **ਤਕਨੀਕਾਂ**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ)

### ਵਿਸ਼ੇਸ਼ ਰਚਨਾ

- ਪਾਠ ਅਧਾਰਿਤ ਸਿੱਖਣਯੋਗ ਰਿਪੋਜ਼ਿਟਰੀ
- ਹਰ ਪਾਠ ਫੋਲਡਰ README, ਕੋਡ ਉਦਾਹਰਣਾਂ, ਅਤੇ ਸਮਾਧਾਨਾਂ ਨਾਲ ਭਰਪੂਰ
- ਵੱਖ-ਵੱਖ ਡਾਇਰੈਕਟਰੀਆਂ ਵਿੱਚ ਅਲੱਗ ਪ੍ਰੋਜੈਕਟ (quiz-app, ਅਨੇਕ ਪਾਠ ਪ੍ਰੋਜੈਕਟ)
- GitHub Actions (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          # ਏਪੀਆਈ ਸਰਵਰ ਸ਼ੁਰੂ ਕਰੋ
npm run lint       # ESLint ਚਲਾਓ
npm run format     # ਪ੍ਰੀਟੀਅਰ ਨਾਲ ਫਾਰਮੇਟ ਕਰੋ
```

### ਬਰਾਊਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ ਪ੍ਰੋਜੈਕਟ

```bash
cd 5-browser-extension/solution
npm install
# ਬਰਾਊਜ਼ਰ-ਵਿਸ਼ੇਸ਼ ਐਕਸਟੈਂਸ਼ਨ ਲੋਡ ਕਰਨ ਦੇ ਨਿਰਦੇਸ਼ਾਂ ਦਾ ਪਾਲਣ ਕਰੋ
```

### ਸਪੇਸ ਗੇਮ ਪ੍ਰੋਜੈਕਟ

```bash
cd 6-space-game/solution
npm install
# ਇੰਡੈਕਸ.html ਨੂੰ ਬ੍ਰਾਊਜ਼ਰ ਵਿੱਚ ਖੋਲ੍ਹੋ ਜਾਂ ਲਾਈਵ ਸਰਵਰ ਵਰਤੋਂ
```

### ਚੈਟ ਪ੍ਰੋਜੈਕਟ (Python ਬੈਕਏਂਡ)

```bash
cd 9-chat-project/solution/backend/python
pip install openai
# GITHUB_TOKEN ਵਾਤਾਵਰਣ ਚਲ ਬਦਲੋ ਸੈਟ ਕਰੋ
python api.py
```

## ਵਿਕਾਸ ਵਰਕਫਲੋ

### ਸਮੱਗਰੀ ਯੋਗਦਾਨਕਾਰਾਂ ਲਈ

1. ਆਪਣਾ GitHub ਖਾਤਾ ਵਿੱਚ ਰਿਪੋਜ਼ਿਟਰੀ ਨੂੰ ਫੌਰਕ ਕਰੋ
2. ਲੋ컬ੀ ਆਪਣੇ ਫੌਰਕ ਨੂੰ ਕਲੋਨ ਕਰੋ
3. ਆਪਣੇ ਬਦਲਾਅ ਲਈ ਨਵੀਂ ਬ੍ਰਾਂਚ ਬਣਾਓ
4. ਪਾਠ ਸਮੱਗਰੀ ਜਾਂ ਕੋਡ ਉਦਾਹਰਣਾਂ ਵਿੱਚ ਬਦਲਾਅ ਕਰੋ
5. ਸੰਬੰਧਿਤ ਪ੍ਰੋਜੈਕਟ ਡਾਇਰੈਕਟਰੀਆਂ ਵਿੱਚ ਕੋਡ ਬਦਲਾਅ ਦੀ ਜਾਂਚ ਕਰੋ
6. ਯੋਗਦਾਨ ਦਿਓ ਧਿਆਨ ਦਿੰਦੇ ਹੋਏ ਪੂਲ ਰਿਕਵੇਸਟ ਸਬਮਿਟ ਕਰੋਂ

### ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ

1. ਰਿਪੋਜ਼ਿਟਰੀ ਨੂੰ ਫੌਰਕ ਜਾਂ ਕਲੋਨ ਕਰੋ
2. ਲੈਸਨ ਡਾਇਰੈਕਟਰੀਆਂ ਵਿੱਚ ਕ੍ਰਮਵਾਰ ਜਾਓ
3. ਹਰ ਪਾਠ ਲਈ README ਫਾਇਲਾਂ ਪੜ੍ਹੋ
4. ਪਹਿਲਾਂ ਲੈਸਨ ਬਣਾਉਣ ਵਾਲੇ ਕਵਿਜ਼ ਨੂੰ https://ff-quizzes.netlify.app/web/ ਤੇ ਪੂਰਾ ਕਰੋ
5. ਪਾਠ ਫੋਲਡਰਾਂ ਵਿੱਚ ਕੋਡ ਉਦਾਹਰਣਾਂ 'ਤੇ ਕੰਮ ਕਰੋ
6. ਅਸਾਇਨਮੈਂਟ ਅਤੇ ਚੈਲੇਂਜ ਪੂਰੇ ਕਰੋ
7. ਬਾਅਦ ਦੇ ਲੈਸਨ ਕਵਿਜ਼ ਲਵੋ

### ਲਾਈਵ ਵਿਕਾਸ

- **ਦਸਤਾਵੇਜ਼**: ਰੂਟ ਵਿੱਚ `docsify serve` ਚਲਾਓ (ਪੋਰਟ 3000)
- **ਕਵਿਜ਼ ਐਪ**: `quiz-app` ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ `npm run dev` ਚਲਾਓ
- **ਪ੍ਰੋਜੈਕਟਾਂ**: HTML ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ VS Code Live Server ਐਕਸਟੈਂਸ਼ਨ ਵਰਤੋਂ
- **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     # ਬਿਨਾਂ ਗਲਤੀਆਂ ਦੇ ਸਰਵਰ ਸ਼ੁਰੂ ਹੋਣ ਦੀ ਜਾਂਚ ਕਰੋ
```

### ਆਮ ਟੈਸਟਿੰਗ ਪਹੁੰਚ

- ਇਹ ਇੱਕ ਸਿੱਖਣਯੋਗ ਰਿਪੋਜ਼ਿਟਰੀ ਹੈ ਜਿਸ ਵਿੱਚ ਪੂਰਨ ਆਟੋਮੈਟਿਕ ਟੈਸਟ ਨਹੀਂ ਹਨ
- ਮੈਨੁਅਲ ਟੈਸਟਿੰਗ ‘ਤੇ ਧਿਆਨ:
  - ਕੋਡ ਉਦਾਹਰਣਾਂ ਬਿਨਾਂ ਗਲਤੀਆਂ ਚੱਲ ਰਹੇ ਹੋਣ
  - ਦਸਤਾਵੇਜ਼ਾਂ ਵਿੱਚ ਲਿੰਕ ਠੀਕ ਕੰਮ ਕਰ ਰਹੇ ਹੋਣ
  - ਪ੍ਰੋਜੈਕਟ ਬਿਲਡ ਸਫਲਤਾਪੂਰਵਕ ਹੋਣ
  - ਉਦਾਹਰਣਾਂ ਵਧੀਆ ਪ੍ਰਥਾਵਾਂ ਦੀ ਪਾਲਣਾ ਕਰ ਰਹੇ ਹੋਣ

### ਪੂਰਵ-ਦਾਖਲਾ ਚੈੱਕ

- `package.json` ਵਾਲੇ ਫੋਲਡਰਾਂ ਵਿੱਚ `npm run lint` ਚਲਾਓ
- ਮਾਰਕਡਾਊਨ ਲਿੰਕਾਂ ਦੀ ਸੰਪੂਰਨਤਾ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ
- ਕੋਡ ਉਦਾਹਰਣ ਬ੍ਰਾਉਜ਼ਰ ਜਾਂ Node.js ਵਿੱਚ ਟੈਸਟ ਕਰੋ
- ਅਨੁਵਾਦਾਂ ਦੀ ਸਠਿਕ ਰਚਨਾ ਬਰਕਰਾਰ ਰਹਿੰਦੀ ਹੈ ਜਾਂ ਨਹੀਂ ਚੈੱਕ ਕਰੋ

## ਕੋਡ ਸਟਾਈਲ ਨਿਰਦੇਸ਼

### JavaScript

- ਆਧੁਨਿਕ ES6+ ਵਾਕਯਾਂ ਨੂੰ ਵਰਤੋਂ
- ਪ੍ਰਾਜੈਕਟਾਂ ਵਿੱਚ ਦਿੱਤੇ ਗਏ ESLint ਵਿਵਸਥਾਪਨ ਦੀ ਪਾਲਣਾ ਕਰੋ
- ਸਿੱਖਣ ਦੀ ਸਪਸ਼ਟਤਾ ਲਈ ਮਾਇਨੇਵਾਲੇ ਵੈਰੀਅਬਲ ਅਤੇ ਫੰਕਸ਼ਨ ਨਾਮ ਵਰਤੋਂ
- ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ ਧਾਰਨਾ ਸਮਝਾਉਣ ਵਾਲੇ ਟਿੱਪਣੀਆਂ ਜੋੜੋ
- ਜਿੱਥੇ ਲਾਗੂ ਹੋਵੇ ਪ੍ਰੀਟੀਅਰ ਨਾਲ ਫਾਰਮੈਟ ਕਰੋ

### 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/ ਫੋਲਡਰ ਬਣਾਉਂਦਾ ਹੈ
# ਮੈਨ branch 'ਤੇ push ਕਰਨ 'ਤੇ GitHub Actions ਵਰਕਫਲੋ ਰਾਹੀਂ ਡਿਪਲੌਏਂਡ ਕਰਦਾ ਹੈ
```

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               # docs ਤੋਂ PDF ਬਣਾਓ
```

### Docsify ਦਸਤਾਵੇਜ਼

```bash
npm install -g docsify-cli    # ਡੌਕਸੀਫਾਈ ਨੂੰ ਗਲੋਬਲੀ ਇੰਸਟਾਲ ਕਰੋ
docsify serve                 # ਲੋਕਲਹੋਸਟ:3000 'ਤੇ ਸਰਵ ਕਰੋ
```

### ਪ੍ਰੋਜੈਕਟ-ਵਿਸ਼ੇਸ਼ ਬਿਲਡ

ਹਰ ਪ੍ਰੋਜੈਕਟ ਡਾਇਰੈਕਟਰੀ ਦਾ ਆਪਣਾ ਬਿਲਡ ਪ੍ਰਕਿਰਿਆ ਹੋ ਸਕਦਾ ਹੈ:
- Vue ਪ੍ਰੋਜੈਕਟ: `npm run build` ਨਾਲ ਉਤਪਾਦਨ ਬੰਨਲ ਬਣਾਓ
- ਸਟੈਟਿਕ ਪ੍ਰੋਜੈਕਟ: ਕੋਈ ਬਿਲਡ ਨਹੀਂ, ਸਿੱਧੇ ਫਾਇਲਾਂ ਸੇਵਾ ਕਰੋ

## ਪੂਲ ਰਿਕਵੇਸਟ ਨਿਯਮ

### ਸਿਰਲੇਖ ਫਾਰਮੈਟ

ਸਪਸ਼ਟ, ਵਰਣਨਾਤਮਕ ਸਿਰਲੇਖ ਜੋ ਬਦਲਾਅ ਦੇ ਖੇਤਰ ਨੂੰ ਦਰਸਾਉਂਦੇ ਹਨ:
- `[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`

### ਲੋੜੀਂਦੇ ਚੈੱਕਸ

ਪੂਲ ਰਿਕਵੇਸਟ ਭੇਜਣ ਤੋਂ ਪਹਿਲਾਂ:

1. **ਕੋਡ ਕੁਆਲਿਟੀ**:
   - ਪ੍ਰਭਾਵਿਤ ਪ੍ਰੋਜੈਕਟ ਡਾਇਰੈਕਟਰੀਆਂ ਵਿੱਚ `npm run lint` ਚਲਾਓ
   - ਸਾਰੇ ਲਿੰਟ ਗਲਤੀਆਂ ਅਤੇ ਚੇਤਾਵਨੀ ਦੂਰ ਕਰੋ

2. **ਬਿਲਡ ਪੁਸ਼ਟੀ**:
   - ਜੇ ਲਾਗੂ ਹੋਵੇ ਤਾਂ `npm run build` ਚਲਾਓ
   - ਕੋਈ ਬਿਲਡ ਗਲਤੀ ਨਹੀਂ ਹੋਣ

3. **ਲਿੰਕ ਵੈਧਤਾ**:
   - ਸਾਰੇ ਮਾਰਕਡਾਊਨ ਲਿੰਕ ਟੈਸਟ ਕਰੋ
   - ਚਿੱਤਰ ਸੰਦਰਭਾਂ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ

4. **ਸਮੱਗਰੀ ਸਮੀਖਿਆ**:
   - ਸਪੈਲਿੰਗ ਅਤੇ ਵਿਆਕਰਨ ਲਈ ਪ੍ਰੂਫਰੀਡ ਕਰੋ
   - ਕੋਡ ਉਦਾਹਰਣ ਸਹੀ ਅਤੇ ਸਿੱਖਣਯੋਗ ਹੋਣ
   - ਅਨੁਵਾਦਾਂ ਦਾ ਮੂਲ ਅਰਥ ਬਣਿਆ ਰਹੇ ਇਹ ਚੈੱਕ ਕਰੋ

### ਯੋਗਦਾਨ ਲੈਣ ਦੀਆਂ ਸ਼ਰਤਾਂ

- ਮਾਈਕ੍ਰੋਸਾਫਟ CLA (ਸਵੈਚਾਲਿਤ ਜਾਂਚ ਪਹਿਲੀ PR ‘ਤੇ) ਨੂੰ ਮਨਜ਼ੂਰ ਕਰੋ
- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) ਦੀ ਪਾਲਣਾ ਕਰੋ
- ਵਿਸਥਾਰ ਲਈ [CONTRIBUTING.md](./CONTRIBUTING.md) ਵੇਖੋ
- ਜੇ ਲਾਗੂ ਹੋਵੇ ਤਾਂ PR ਵੇਰਵੇ ਵਿੱਚ ਮੁੱਦੇ ਨੰਬਰ ਦਰਜ ਕਰੋ

### ਸਮੀਖਿਆ ਪ੍ਰਕਿਰਿਆ

- PRs ਨੂੰ ਮੇਂਟੇਨਰਾਂ ਅਤੇ ਕਮਿਊਨਿਟੀ ਵੱਲੋਂ ਸਮੀਖਿਆ ਕੀਤੀ ਜਾਂਦੀ ਹੈ
- ਸਿੱਖਣਯੋਗ ਸਪਸ਼ਟਤਾ ਪ੍ਰਾਥਮਿਕਤਾ ਹੈ
- ਕੋਡ ਉਦਾਹਰਣ ਮੌਜੂਦਾ ਵਧੀਆ ਅਭਿਆਸਾਂ ਦੀ ਪਾਲਣਾ ਕਰਨੇ ਚਾਹੀਦੇ ਹਨ
- ਅਨੁਵਾਦਾਂ ਦੀ ਸੁਨਿਸ਼ਚਿਤਤਾ ਅਤੇ ਸਾਂਸਕ੍ਰਿਤਿਕ ਉਚਿਤਤਾ ਲਈ ਸਮੀਖਿਆ

## ਅਨੁਵਾਦ ਸਿਸਟਮ

### ਸਵੈਚਾਲਿਤ ਅਨੁਵਾਦ

- GitHub Actions ਨਾਲ co-op-translator ਵਰਕਫਲੋ ਵਰਤਦਾ ਹੈ
- 50+ ਭਾਸ਼ਾਵਾਂ ਵਿੱਚ ਸਵੈਚਾਲਿਤ ਤੌਰ 'ਤੇ ਅਨੁਵਾਦ ਕਰਦਾ ਹੈ
- ਸੋ스 ਫਾਇਲਾਂ ਮੁੱਖ ਡਾਇਰੈਕਟਰੀਆਂ ਵਿੱਚ ਹਨ
- ਅਨੁਵਾਦ ਕੀਤੀਆਂ ਫਾਇਲਾਂ `translations/{language-code}/` ਵਿੱਚ ਹਨ

### ਮੈਨੁਅਲ ਅਨੁਵਾਦ ਸੁਧਾਰ ਜੋੜਨਾ

1. `translations/{language-code}/` ਵਿੱਚ ਫਾਇਲ ਲੱਭੋ
2. ਸੰਰਚਨਾ ਨੂੰ ਸੁਰੱਖਿਅਤ ਰੱਖਦਿਆਂ ਸੁਧਾਰ ਕਰੋ
3. ਕੋਡ ਉਦਾਹਰਣ ਕੰਮਕਾਜ਼ ਹੁੰਦੇ ਰਹਿੰਦੇ ਹਨ ਇਹ ਯਕੀਨੀ ਬਣਾਓ
4. ਕਿਸੇ ਵੀ ਸਥਾਨਕ ਕਵਿਜ਼ ਸਮੱਗਰੀ ਦੀ ਜਾਂਚ ਕਰੋ

### ਅਨੁਵਾਦ ਮੈਟਾ ਡੇਟਾ

ਅਨੁਵਾਦ ਕੀਤੀਆਂ ਫਾਇਲਾਂ metadata ਹੈੱਡਰ ਸ਼ਾਮਲ ਕਰਦੀਆਂ ਹਨ:
```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 ਵਾਤਾਵਰਣ ਚਰ (environment variable) ਸੈੱਟ ਹੈ ਜਾਂ ਨਹੀਂ
- GitHub ਮਾਡਲਜ਼ ਐਕਸੈਸ ਪਰਮਿਸ਼ਨਾਂ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ

**Docsify ਦਸਤਾਵੇਜ਼ ਸੇਵਾ ਨਹੀਂ ਕਰ ਰਿਹਾ**:
- docsify-cli ਗਲੋਬਲ ਇੰਸਟਾਲ ਕਰੋ: `npm install -g docsify-cli`
- ਰਿਪੋਜ਼ਿਟਰੀ ਰੂਟ ਡਾਇਰੈਕਟਰੀ ਤੋਂ ਚਲਾਓ
- `docs/_sidebar.md` ਮੌਜੂਦ ਹੈ ਜਾਂ ਨਹੀਂ ਜਾਂਚੋ

### ਵਿਕਾਸ ਵਾਤਾਵਰਣ ਟਿਪਸ

- HTML ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ VS Code ਵਿੱਚ Live Server ਐਕਸਟੈਂਸ਼ਨ ਵਰਤੋਂ
- ESLint ਅਤੇ Prettier ਐਕਸਟੈਂਸ਼ਨਾਂ ਨੂੰ ਅਨੁਕੂਲ ਫਾਰਮੈਟਿੰਗ ਲਈ ਇੰਸਟਾਲ ਕਰੋ
- ਜਾਵਾਸਕ੍ਰਿਪਟ ਲਈ ਬਰਾਊਜ਼ਰ ਡਿਵੈਲਪਰ ਟੂਲਜ਼ ਵਰਤੋਂ
- Vue ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ Vue DevTools ਬਰਾਊਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ ਇੰਸਟਾਲ ਕਰੋ

### ਪ੍ਰਦਰਸ਼ਨ ਦੀਆਂ ਗੱਲਾਂ

- ਵੱਡੀ ਗਿਣਤੀ ਵਿੱਚ ਅਨੁਵਾਦਤ ਫਾਇਲਾਂ (50+ ਭਾਸ਼ਾਵਾਂ) ਦੀ ਵਜੇ ਨਾਲ ਪੂਰੇ ਕਲੋਨ ਵੱਡੇ ਹਨ
- ਕੇਵਲ ਸਮੱਗਰੀ 'ਤੇ ਕੰਮ ਕਰ ਰਹੇ ਹੋ ਤਾਂ shallow clone ਵਰਤੋਂ: `git clone --depth 1`
- ਅੰਗਰੇਜ਼ੀ ਸਮੱਗਰੀ ’ਤੇ ਕੰਮ ਕਰਦਿਆਂ ਅਨੁਵਾਦਾਂ ਨੂੰ ਖੋਜ ਤੋਂ ਬਾਹਰ ਰੱਖੋ
- ਪਹਿਲੀ ਵਾਰੀ npm install ਅਤੇ Vite build ਦੇ ਕਾਰਨ ਬਿਲਡ ਪ੍ਰਕਿਰਿਆ ਧੀਮੀ ਹੋ ਸਕਦੀ ਹੈ

## ਸੁਰੱਖਿਆ ਦੀਆਂ ਗੱਲਾਂ

### ਵਾਤਾਵਰਣ ਚਰ

- API ਕੁੰਜੀਆਂ ਕਦੇ ਵੀ ਰਿਪੋਜ਼ਿਟਰੀ ਵਿੱਚ ਕਮਿੱਟ ਨਾ ਕਰੋ
- `.env` ਫਾਇਲਾਂ ਵਰਤੋ (ਜੋ `.gitignore` ਵਿੱਚ ਹਨ)
- ਲੋੜੀਂਦੇ ਵਾਤਾਵਰਣ ਚਰ ਨੂੰ ਪ੍ਰੋਜੈਕਟ README ਫਾਇਲਾਂ ਵਿੱਚ ਦਰਜ ਕਰੋ

### Python ਪ੍ਰੋਜੈਕਟ

- ਵਰਚੁਅਲ ਵਾਤਾਵਰਣ ਵਰਤੋ: `python -m venv venv`
- ਡਿਪੇਂਡੈਂਸੀਜ਼ ਅਪਡੇਟ ਰੱਖੋ
- GitHub ਟੋਕੇਨ ਨੂੰ ਘੱਟੋ ਘੱਟ ਲੋੜੀਂਦੇ ਅਧਿਕਾਰਾਂ ਨਾਲ ਵਰਤੋਂ

### GitHub ਮਾਡਲ ਐਕਸੈਸ

- GitHub ਮਾਡਲਾਂ ਲਈ ਪਰਸਨਲ ਐਕਸੈਸ ਟੋਕੇਨ (PAT) ਲੋੜੀਂਦੇ ਹਨ
- ਟੋਕੇਨ ਵਾਤਾਵਰਣ ਚਰ ਵਜੋਂ ਰੱਖੋ
- ਟੋਕੇਨ ਜਾਂ ਪ੍ਰਮਾਣ ਪੱਤਰ ਕਦੇ ਵੀ ਕਮਿੱਟ ਨਾ ਕਰੋ

## ਵਧੂ ਨੋਟਸ

### ਲਕੜਾਰਥ ਸੰਗ੍ਰਾਹਕ

- ਵੈੱਬ ਵਿਕਾਸ ਵਿੱਚ ਪੂਰਨ ਸ਼ੁਰੂਆਤੀ
- ਵਿਦਿਆਰਥੀ ਅਤੇ ਖੁਦ ਸਿੱਖਣ ਵਾਲੇ
- ਕਲਾਸਰੂਮਾਂ ਵਿੱਚ ਸਿਲੇਬਸ ਦਾ ਉਪਯੋਗ ਕਰਨ ਵਾਲੇ ਅਧਿਆਪਕ
- ਸਮੱਗਰੀ ਪਹੁੰਚਯੋਗਤਾ ਅਤੇ ਕਦਮ-ਦਰ-ਕਦਮ ਕੌਸ਼ਲ ਵਿਕਾਸ ਲਈ ਤਿਆਰ ਕੀਤੀ ਗਈ ਹੈ

### ਸਿੱਖਣ ਦੀ ਦਾਰਸ਼ਨਿਕਤਾ

- ਪ੍ਰੋਜੈਕਟ-ਆਧਾਰਿਤ ਸਿੱਖਣ ਦੀ ਪਢ਼ਤਾਲ
- ਮੁੜ-ਮੁੜ ਗਿਆਨ ਦੀ ਜਾਂਚ (ਕਵਿਜ਼)
- ਹੱਥ-ਵਿੱਚ ਕੋਡਿੰਗ ਅਭਿਆਸ
- ਅਸਲੀ ਦੁਨੀਆ ਦੇ ਉਦਾਹਰਣ
- ਫਰੇਮਵਰਕਾਂ ਤੋਂ ਪਹਿਲਾਂ ਬੁਨਿਆਦੀ ਜਾਣਕਾਰੀ ’ਤੇ ਧਿਆਨ

### ਰਿਪੋਜ਼ਿਟਰੀ ਦਾ ਸੰਭਾਲ

- ਸਿੱਖਣ ਵਾਲਿਆਂ ਅਤੇ ਯੋਗਦਾਨਕਾਰਾਂ ਦੀ ਸਰਗਰਮ ਸਮੁਦਾਇ
- ਡਿਪੈਂਡੈਂਸੀਜ਼ ਅਤੇ ਸਮੱਗਰੀ ਦਾ ਨਿਯਮਤ ਅੱਪਡੇਟ
- ਮੈਨਟੇਨਰਾਂ ਵੱਲੋਂ ਮੁੱਦੇ ਅਤੇ ਗੱਲਬਾਤਨੂੰ ਨਿਗਰਾਨੀ
- ਅਨੁਵਾਦਾਂ ਦੇ ਅੱਪਡੇਟ GitHub Actions ਰਾਹੀਂ ਆਟੋਮੈਟਿਕ

### ਸੰਬੰਧਤ ਸਰੋਤ

- [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 ਸਿਲੇਬਸ ਉਪਲਬਧ

### ਨਿਰਧਾਰਿਤ ਪ੍ਰੋਜੈਕਟਾਂ ਨਾਲ ਕੰਮ

ਵਿਸਥਾਰਿਤ ਨਿਰਦੇਸ਼ਾਂ ਲਈ ਹਰੇਕ ਪ੍ਰੋਜੈਕਟ 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 ਚੈਟ ਅਸਿਸਟੈਂਟ ਪ੍ਰੋਜੈਕਟ

### ਮੋਨੋਰੇਪੋ ਸੰਰਚਨਾ

ਇਹ ਪਾਰੰਪਰਿਕ ਮੋਨੋਰੇਪੋ ਨਹੀਂ ਹੈ ਪਰ ਇਸ ਵਿੱਚ ਬਹੁਤ ਸਾਰੇ ਸੁਤੰਤਰ ਪ੍ਰੋਜੈਕਟ ਹਨ:
- ਹਰ ਪਾਠ ਖੁਦਮੁਖਤਿਆਰ ਹੈ
- ਪ੍ਰੋਜੈਕਟਾਂ ਵਿੱਚ ਸਾਂਝੇ ਡਿਪੈਂਡੈਂਸੀਜ਼ ਨਹੀਂ ਹਨ
- ਇਕ-ਦੂਜੇ ਉੱਤੇ ਪ੍ਰਭਾਵ ਨਾ ਪਾਉਂਦੇ ਹੋਏ ਵੱਖ-ਵੱਖ ਪ੍ਰੋਜੈਕਟਾਂ ’ਤੇ ਕੰਮ ਕਰੋ
- ਪੂਰਾ ਸਿਲੇਬਸ ਅਨੁਭਵ ਲਈ ਸਾਰੀ ਰਿਪੋ ਕਲੋਨ ਕਰੋ

---

<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**ਅਸਵੀਕਾਰੋpetition**:  
ਇਸ ਦਸਤਾਵੇਜ਼ ਦਾ ਅਨੁਵਾਦ AI ਅਨੁਵਾਦ ਸੇਵਾ [Co-op Translator](https://github.com/Azure/co-op-translator) ਦੀ ਵਰਤੋਂ ਨਾਲ ਕੀਤਾ ਗਿਆ ਹੈ। ਜਦੋਂ ਕਿ ਅਸੀਂ ਸ਼ੁੱਧਤਾ ਲਈ ਕੋਸ਼ਿਸ਼ ਕਰਦੇ ਹਾਂ, ਕਿਰਪਾ ਕਰਕੇ ਧਿਆਨ ਰੱਖੋ ਕਿ ਸਵਚਾਲਿਤ ਅਨੁਵਾਦਾਂ ਵਿੱਚ ਗਲਤੀਆਂ ਜਾਂ ਅਸੰਸ਼ੋਧਿਤੀਆਂ ਹੋ ਸਕਦੀਆਂ ਹਨ। ਇਸ ਦਾ ਮੂਲ ਦਸਤਾਵੇਜ਼ ਆਪਣੀ ਮੂਲ ਭਾਸ਼ਾ ਵਿੱਚ ਇਸਦਾ ਪ੍ਰਮਾਣਿਕ ਸਰੋਤ ਮੰਨਿਆ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ। ਮਹੱਤਵਪੂਰਣ ਜਾਣਕਾਰੀ ਲਈ ਵਿਸ਼ੇਸ਼ਗੀ ਮਨੁੱਖੀ ਅਨੁਵਾਦ ਦੀ ਸਿਫ਼ਾਰਸ਼ ਕੀਤੀ ਜਾਂਦੀ ਹੈ। ਅਸੀਂ ਇਸ ਅਨੁਵਾਦ ਦੀ ਵਰਤੋਂ ਤੋਂ ਉਪਜਣ ਵਾਲੀਆਂ ਕਿਸੇ ਵੀ ਗਲਤਫ਼ਹਮੀ ਜਾਂ ਗਲਤ ਵਿਵਿਚਾਰ ਲਈ ਜ਼ਿੰਮੇਵਾਰ ਨਹੀਂ ਹਾਂ।
<!-- CO-OP TRANSLATOR DISCLAIMER END -->