Web-Dev-For-Beginners/translations/pa/AGENTS.md

# AGENTS.md

## ਪ੍ਰੋਜੈਕਟ ਸਾਰਾਂਸ਼

ਇਹ ਸ਼ੁਰੂਆਤੀ ਵਿਦਿਆਰਥੀਆਂ ਨੂੰ ਵੈੱਬ ਵਿਕਾਸ ਦੇ ਮੁਢਲੇ ਤੱਤ ਸਿਖਾਉਣ ਲਈ ਇੱਕ ਸਿੱਖਿਆਮੁਖ ਰੀਪੋਜ਼ਟਰੀ ਹੈ। ਇਹ ਕੋਰਸ ਮਾਈਕ੍ਰੋਸਾਫਟ ਕਲਾਉਡ ਐਡਵੋਕੇਟਸ ਦੁਆਰਾ ਵਿਕਸਤ ਕੀਤੀ ਗਈ 12 ਹਫਤਿਆਂ ਦੀ ਇੱਕ ਵਿਸਤ੍ਰਿਤ ਕੋਰਸ ਹੈ, ਜਿਸ ਵਿੱਚ ਜਾਵਾਸਕ੍ਰਿਪਟ, CSS ਅਤੇ HTML ਦੇ 24 ਪ੍ਰਯੋਗਾਤਮਕ ਪਾਠ ਸ਼ਾਮਲ ਹਨ।

### ਮੁੱਖ ਹਿੱਸੇ

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

### ਢਾਂਚਾ

- ਪਾਠਾਂ ਅਧਾਰਿਤ ਸਿਖਿਆਮੁਖ ਰੀਪੋਜ਼ਟਰੀ  
- ਹਰ ਪਾਠ ਫੋਲਡਰ ਵਿੱਚ 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     # Prettier ਨਾਲ ਫਾਰਮੈਟ ਕਰੋ
```
  
### ਬਰਾਊਜ਼ਰ ਐਕਸਟੈਨਸ਼ਨ ਪ੍ਰੋਜੈਕਟ

```bash
cd 5-browser-extension/solution
npm install
# ਬ੍ਰਾਉਜ਼ਰ-ਖਾਸ ਐਕਸਟੈਂਸ਼ਨ ਲੋਡਿੰਗ ਨਿਰਦੇਸ਼ਾਂ ਦੀ ਪਾਲਣਾ ਕਰੋ
```
  
### ਸਪੇਸ ਗੇਮ ਪ੍ਰੋਜੈਕਟ

```bash
cd 6-space-game/solution
npm install
# index.html ਨੂੰ ਬ੍ਰਾਉਜ਼ਰ ਵਿੱਚ ਖੋਲ੍ਹੋ ਜਾਂ ਲਾਈਵ ਸਰਵਰ ਦੀ ਵਰਤੋਂ ਕਰੋ
```
  
### ਚੈਟ ਪ੍ਰੋਜੈਕਟ (ਪਾਇਥਨ ਬੈਕਇੰਡ)

```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 ਅਨੁਕੂਲਤਾ  
- ਸਿੱਖਣ ਲਈ ਸਾਫ਼ ਉਦਾਹਰਣ  
- ਸਮਝ ਵਧਾਉਣ ਲਈ ਟਾਈਪ ਹਿੰਟਸ  

### Markdown ਡੌਕੂਮੈਂਟੇਸ਼ਨ

- ਸਪਸ਼ਟ ਸਿਰਲੇਖ ਹਾਇਰਾਰਕੀ  
- ਭਾਸ਼ਾ ਬਾਰੇ ਜਾਣਕਾਰੀ ਸਮੇਤ ਕੋਡ ਬਲੌਕ  
- ਵਾਧੂ ਸਾਧਨਾਂ ਲਈ ਲਿੰਕ  
- `images/` ਡਿਰੈਕਟਰੀ ਵਿੱਚ ਸਕ੍ਰੀਨਸ਼ਾਟ ਅਤੇ ਚਿੱਤਰ  
- ਵਰਣਣਾਤਮਕ Alt ਪਾਠ ਚਿੱਤਰ ਲਈ  

### ਫਾਈਲ ਸੰਗਠਨ

- ਲੜੀਵਾਰ ਨੰਬਰਬੰਦੀ (1-getting-started-lessons, 2-js-basics, ਆਦਿ)  
- ਹਰ ਪ੍ਰੋਜੈਕਟ ਵਿੱਚ `solution/` ਅਤੇ ਅਕਸਰ `start/` ਜਾਂ `your-work/` ਫੋਲਡਰ  
- ਪਾਠ-ਵਿਸ਼ੇਸ਼ `images/` ਫੋਲਡਰਾਂ ਵਿੱਚ ਚਿੱਤਰ  
- `translations/{language-code}/` ਅਨੁਵਾਦ ਸੰਰਚਨਾ  

## ਨਿਰਮਾਣ ਅਤੇ ਤਿਆਰ ਕਰਨਾ

### ਕੁਇਜ਼ ਐਪ ਤਿਆਰ ਕਰਨਾ (Azure Static Web Apps)

ਕੁਇਜ਼-ਐਪ ਨੂੰ 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`  

### ਡੌਕੂਮੈਂਟੇਸ਼ਨ 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] ਟੈਰੀਰੀਅਮ ਪ੍ਰੋਜੈਕਟ ਵਿੱਚ ਟਾਈਪੋ ਠੀਕ ਕਰੋ`  
- `[Translation] ਪਾਠ 5 ਲਈ ਸਪੈਨਿਸ਼ ਅਨੁਵਾਦ ਸ਼ਾਮਲ ਕਰੋ`  
- `[Docs] ਸੈਟਅਪ ਨਿਰਦੇਸ਼ਾਂ ਨੂੰ ਅਪਡੇਟ ਕਰੋ`  

### ਲਾਜ਼ਮੀ ਜਾਂਚਾਂ

ਪੁਲ ਰਿਕਵੇਸਟ ਜਮ੍ਹਾਂ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ:

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

2. **ਨਿਰਮਾਣ ਪੱਕੇ ਕਰੋ**:  
   - ਲਾਗੂ ਹੋਣ 'ਤੇ `npm run build` ਚਲਾਓ  
   - ਕੋਈ ਬਣਾਉਣ ਵਾਲੀ ਗਲਤੀ ਨਾ ਹੋਵੇ  

3. **ਲਿੰਕ ਦੀ ਸਹੀਤਾ**:  
   - ਸਾਰੇ ਮਾਰਕਡਾਊਨ ਲਿੰਕ ਟੈਸਟ ਕਰੋ  
   - ਚਿੱਤਰਾਂ ਦੇ ਰੈਫਰੈਂਸ ਕੰਮ ਕਰਦੇ ਹੋਣ  

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

### ਯੋਗਦਾਨ ਲੈਣ ਦੇ ਨਿਯਮ

- Microsoft 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. ਕੋਈ ਵੀ ਸਥਾਨਕ ਕੁਇਜ਼ ਸਮੱਗਰੀ ਟੈਸਟ ਕਰੋ  

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

ਅਨੁਵਾਦ ਫਾਈਲਾਂ ਵਿੱਚ ਮੈਟਾਡੇਟਾ ਹੈਡਰ ਸ਼ਾਮਲ:  
```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 ਠੀਕ ਫਾਰਮੈਟ ਕੀਤਾ ਹੋਇਆ ਹੈ ਜਾਂ ਨਹੀਂ  
- ਬਰਾਊਜ਼ਰ ਕੰਸੋਲ ਵਿੱਚ ਗਲਤੀਆਂ ਦੀ ਜਾਂਚ  
- ਬਰਾਊਜ਼ਰ-ਖ਼ਾਸ ਐਕਸਟੈਨਸ਼ਨ ਇੰਸਟਾਲੇਸ਼ਨ ਹਦਾਇਤਾਂ ਦੀ ਪਾਲਣਾ ਕਰੋ  

**ਪਾਇਥਨ ਚੈਟ ਪ੍ਰੋਜੈਕਟ ਸਮੱਸਿਆਵਾਂ**:  
- OpenAI ਪੈਕੇਜ ਇੰਸਟਾਲ ਹੈ: `pip install openai`  
- GITHUB_TOKEN ਵਾਤਾਵਰਣ ਵੈਰੀਏਬਲ ਸੈੱਟ ਹੈ  
- GitHub ਮਾਡਲ ਐਕਸੈਸ ਪਰਮੀਸ਼ਨ ਦੀ ਜਾਂਚ ਕਰੋ  

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

### ਵਿਕਾਸ ਵਾਤਾਵਰਨ ਸੁਝਾਵ

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

### ਪ੍ਰਦਰਸ਼ਨ ਜ਼ਰੂਰੀਆਤ

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

## ਸੁਰੱਖਿਆ ਬਾਰੇ

### ਵਾਤਾਵਰਣ ਵੈਰੀਏਬਲ

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

### ਪਾਇਥਨ ਪ੍ਰੋਜੈਕਟ

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

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

- GitHub ਮਾਡਲ ਲਈ Personal Access Tokens (PAT) ਲਾਜ਼ਮੀ  
- ਟੋਕਨ ਵਾਤਾਵਰਣ ਵੈਰੀਏਬਲ ਵਜੋਂ ਸੁਰੱਖਿਅਤ ਰੱਖੋ  
- ਕਦੇ ਵੀ ਟੋਕਨ ਜਾਂ ਸਨਦ ਨਾ ਕਮਿੱਟ ਕਰੋ  

## ਵਧੀਕ ਟਿੱਪਣੀਆਂ

### ਟਾਰਗੇਟ ਦਰਸ਼ਕ

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

### ਸਿੱਖਿਆਮੁਖ ਨਜ਼ਰੀਆ

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

### ਰੀਪੋਜ਼ਟਰੀ ਦੇਖਭਾਲ

- ਸਿੱਖਿਅਕ ਅਤੇ ਯੋਗਦਾਨਕਾਰੀਆਂ ਦੀ ਸਰਗਰਮ ਕਮਿਉਨਿਟੀ  
- ਡਿਪੈਂਡੈਂਸੀਅਾਂ ਅਤੇ ਸਮੱਗਰੀ ਦੀ ਨਿਯਮਤ ਅਪਡੇਟ  
- ਮੈਨਟੇਨਰਾਂ ਵੱਲੋਂ ਮਸਲੇ ਅਤੇ ਚਰਚਾ ਦੀ ਨਿਗਰਾਨੀ  
- GitHub Actions ਨਾਲ ਅਨੁਵਾਦ ਅਪਡੇਟ ਆਟੋਮੈਟਿਕ  

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

- [Microsoft Learn ਮਾਪਡੰਡ](https://docs.microsoft.com/learn/)  
- [Student Hub ਸਰੋਤ](https://docs.microsoft.com/learn/student-hub/)  
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ ਸਿਫਾਰਸ਼ੀ  
- ਵਧੀਕ ਕੋਰਸ: ਜਨਰੇਟਿਵ ਏਆਈ, ਡੇਟਾ ਸਾਇੰਸ, 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` - ਏਆਈ ਚੈਟ ਅਸਿਸਟੈਂਟ ਪ੍ਰੋਜੈਕਟ  

### ਮੋਨੋਰਿਪੋ ਢਾਂਚਾ

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

---

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