AGENTS.md

1# AGENTS.md
2 
3## ਪ੍ਰੋਜੈਕਟ ਓਵਰਵਿਊ
4 
5ਇਹ शुरुआਤੀ ਵੈੱਬ ਵਿੱਕਾਸ਼ ਮੂਲਾਂਕਣ ਸਿਖਾਉਣ ਲਈ ਇੱਕ ਸਿੱਖਣਯੋਗ ਸਿਲੇਬਸ ਰਿਪੋਜ਼ਿਟਰੀ ਹੈ। ਇਹ ਸਿਲੇਬਸ ਮਾਈਕ੍ਰੋਸਾਫਟ ਕਲਾਉਡ ਅਡਵੋਕੇਟਸ ਵੱਲੋਂ ਵਿਕਸੀਤ ਇੱਕ ਸਮੱਗਰੀਤ 12 ਹਫ਼ਤਿਆਂ ਦਾ ਕੋਰਸ ਹੈ, ਜਿਸ ਵਿੱਚ JavaScript, CSS, ਅਤੇ HTML ਦੀਆਂ 24 ਪ੍ਰਯੋਗਸ਼ੀਲ ਲੈਸਨਾਂ ਸ਼ਾਮਲ ਹਨ।
6 
7### ਮੁੱਖ ਘਟਕ
8 
9- **ਸਿੱਖਣਯੋਗ ਸਮੱਗਰੀ**: ਪ੍ਰੋਜੈਕਟ-ਆਧਾਰਿਤ ਮੋਡਿਊਲਾਂ ਵਿੱਚ ਵਿਵਸਥਿਤ 24 ਪਾਠ
10- **ਪ੍ਰਯੋਗਸ਼ੀਲ ਪ੍ਰੋਜੈਕਟ**: ਟੈਰੀਆਰਿਯਮ, ਟਾਈਪਿੰਗ ਗੇਮ, ਬਰਾਊਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ, ਸਪੇਸ ਗੇਮ, ਬੈਂਕਿੰਗ ਐਪ, ਕੋਡ ਐਡੀਟਰ, ਅਤੇ AI ਚੈਟ ਅਸਿਸਟੈਂਟ
11- **ਇੰਟਰਐਕਟਿਵ ਕਵਿਜ਼**: 48 ਕਵਿਜ਼, ਹਰ ਇੱਕ ਵਿੱਚ 3 ਸਵਾਲ (ਪਹਿਲਾਂ/ਬਾਅਦ ਲੈਸਨ ਮੁਲਾਂਕਣ)
12- **ਬਹੁ-ਭਾਸ਼ਾ ਸਹਾਇਤਾ**: GitHub Actions ਦੁਆਰਾ 50+ ਭਾਸ਼ਾਵਾਂ ਵਿੱਚ ਆਟੋਮੈਟਿਕ ਅਨੁਵਾਦ
13- **ਤਕਨੀਕਾਂ**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ)
14 
15### ਵਿਸ਼ੇਸ਼ ਰਚਨਾ
16 
17- ਪਾਠ ਅਧਾਰਿਤ ਸਿੱਖਣਯੋਗ ਰਿਪੋਜ਼ਿਟਰੀ
18- ਹਰ ਪਾਠ ਫੋਲਡਰ README, ਕੋਡ ਉਦਾਹਰਣਾਂ, ਅਤੇ ਸਮਾਧਾਨਾਂ ਨਾਲ ਭਰਪੂਰ
19- ਵੱਖ-ਵੱਖ ਡਾਇਰੈਕਟਰੀਆਂ ਵਿੱਚ ਅਲੱਗ ਪ੍ਰੋਜੈਕਟ (quiz-app, ਅਨੇਕ ਪਾਠ ਪ੍ਰੋਜੈਕਟ)
20- GitHub Actions (co-op-translator) ਨਾਲ ਅਨੁਵਾਦ ਸਿਸਟਮ
21- Docsify ਰਾਹੀਂ ਦਸਤਾਵੇਜ਼ ਸੇਵਾ ਅਤੇ PDF ਉਪਲਬਧ
22 
23## ਸੈਟਅਪ ਕਮਾਂਡਾਂ
24 
25ਇਹ ਰਿਪੋਜ਼ਿਟਰੀ ਮੁੱਖ ਤੌਰ ਤੇ ਸਿੱਖਣਯੋਗ ਸਮੱਗਰੀ ਦੇ ਪ੍ਰਯੋਗ ਲਈ ਹੈ। ਨਿਰਧਾਰਿਤ ਪ੍ਰੋਜੈਕਟਾਂ ਨਾਲ ਕੰਮ ਕਰਨ ਲਈ:
26 
27### ਮੁੱਖ ਰਿਪੋਜ਼ਿਟਰੀ ਸੈਟਅਪ
28 
29```bash
30git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
31cd Web-Dev-For-Beginners
32```
33 
34### ਕਵਿਜ਼ ਐਪ ਸੈਟਅਪ (Vue 3 + Vite)
35 
36```bash
37cd quiz-app
38npm install
39npm run dev        # ਵਿਕਾਸ ਸਰਵਰ ਸ਼ੁਰੂ ਕਰੋ
40npm run build      # ਉਤਪਾਦਨ ਲਈ ਬਿਲਡ ਕਰੋ
41npm run lint       # ESLint ਚਲਾਓ
42```
43 
44### ਬੈਂਕ ਪ੍ਰੋਜੈਕਟ API (Node.js + Express)
45 
46```bash
47cd 7-bank-project/api
48npm install
49npm start          # ਏਪੀਆਈ ਸਰਵਰ ਸ਼ੁਰੂ ਕਰੋ
50npm run lint       # ESLint ਚਲਾਓ
51npm run format     # ਪ੍ਰੀਟੀਅਰ ਨਾਲ ਫਾਰਮੇਟ ਕਰੋ
52```
53 
54### ਬਰਾਊਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ ਪ੍ਰੋਜੈਕਟ
55 
56```bash
57cd 5-browser-extension/solution
58npm install
59# ਬਰਾਊਜ਼ਰ-ਵਿਸ਼ੇਸ਼ ਐਕਸਟੈਂਸ਼ਨ ਲੋਡ ਕਰਨ ਦੇ ਨਿਰਦੇਸ਼ਾਂ ਦਾ ਪਾਲਣ ਕਰੋ
60```
61 
62### ਸਪੇਸ ਗੇਮ ਪ੍ਰੋਜੈਕਟ
63 
64```bash
65cd 6-space-game/solution
66npm install
67# ਇੰਡੈਕਸ.html ਨੂੰ ਬ੍ਰਾਊਜ਼ਰ ਵਿੱਚ ਖੋਲ੍ਹੋ ਜਾਂ ਲਾਈਵ ਸਰਵਰ ਵਰਤੋਂ
68```
69 
70### ਚੈਟ ਪ੍ਰੋਜੈਕਟ (Python ਬੈਕਏਂਡ)
71 
72```bash
73cd 9-chat-project/solution/backend/python
74pip install openai
75# GITHUB_TOKEN ਵਾਤਾਵਰਣ ਚਲ ਬਦਲੋ ਸੈਟ ਕਰੋ
76python api.py
77```
78 
79## ਵਿਕਾਸ ਵਰਕਫਲੋ
80 
81### ਸਮੱਗਰੀ ਯੋਗਦਾਨਕਾਰਾਂ ਲਈ
82 
831. ਆਪਣਾ GitHub ਖਾਤਾ ਵਿੱਚ ਰਿਪੋਜ਼ਿਟਰੀ ਨੂੰ ਫੌਰਕ ਕਰੋ
842. ਲੋ컬ੀ ਆਪਣੇ ਫੌਰਕ ਨੂੰ ਕਲੋਨ ਕਰੋ
853. ਆਪਣੇ ਬਦਲਾਅ ਲਈ ਨਵੀਂ ਬ੍ਰਾਂਚ ਬਣਾਓ
864. ਪਾਠ ਸਮੱਗਰੀ ਜਾਂ ਕੋਡ ਉਦਾਹਰਣਾਂ ਵਿੱਚ ਬਦਲਾਅ ਕਰੋ
875. ਸੰਬੰਧਿਤ ਪ੍ਰੋਜੈਕਟ ਡਾਇਰੈਕਟਰੀਆਂ ਵਿੱਚ ਕੋਡ ਬਦਲਾਅ ਦੀ ਜਾਂਚ ਕਰੋ
886. ਯੋਗਦਾਨ ਦਿਓ ਧਿਆਨ ਦਿੰਦੇ ਹੋਏ ਪੂਲ ਰਿਕਵੇਸਟ ਸਬਮਿਟ ਕਰੋਂ
89 
90### ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ
91 
921. ਰਿਪੋਜ਼ਿਟਰੀ ਨੂੰ ਫੌਰਕ ਜਾਂ ਕਲੋਨ ਕਰੋ
932. ਲੈਸਨ ਡਾਇਰੈਕਟਰੀਆਂ ਵਿੱਚ ਕ੍ਰਮਵਾਰ ਜਾਓ
943. ਹਰ ਪਾਠ ਲਈ README ਫਾਇਲਾਂ ਪੜ੍ਹੋ
954. ਪਹਿਲਾਂ ਲੈਸਨ ਬਣਾਉਣ ਵਾਲੇ ਕਵਿਜ਼ ਨੂੰ https://ff-quizzes.netlify.app/web/ ਤੇ ਪੂਰਾ ਕਰੋ
965. ਪਾਠ ਫੋਲਡਰਾਂ ਵਿੱਚ ਕੋਡ ਉਦਾਹਰਣਾਂ 'ਤੇ ਕੰਮ ਕਰੋ
976. ਅਸਾਇਨਮੈਂਟ ਅਤੇ ਚੈਲੇਂਜ ਪੂਰੇ ਕਰੋ
987. ਬਾਅਦ ਦੇ ਲੈਸਨ ਕਵਿਜ਼ ਲਵੋ
99 
100### ਲਾਈਵ ਵਿਕਾਸ
101 
102- **ਦਸਤਾਵੇਜ਼**: ਰੂਟ ਵਿੱਚ `docsify serve` ਚਲਾਓ (ਪੋਰਟ 3000)
103- **ਕਵਿਜ਼ ਐਪ**: `quiz-app` ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ `npm run dev` ਚਲਾਓ
104- **ਪ੍ਰੋਜੈਕਟਾਂ**: HTML ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ VS Code Live Server ਐਕਸਟੈਂਸ਼ਨ ਵਰਤੋਂ
105- **API ਪ੍ਰੋਜੈਕਟ**: ਸੰਬੰਧਿਤ API ਡਾਇਰੈਕਟਰੀਆਂ ਵਿੱਚ `npm start` ਚਲਾਓ
106 
107## ਟੈਸਟਿੰਗ ਨਿਰਦੇਸ਼
108 
109### ਕਵਿਜ਼ ਐਪ ਟੈਸਟਿੰਗ
110 
111```bash
112cd quiz-app
113npm run lint       # ਕੋਡ ਸਟਾਈਲ ਸਮੱਸਿਆਵਾਂ ਲਈ ਜਾਂਚ ਕਰੋ
114npm run build      # ਨਿਰਮਾਣ ਸਫਲ ਹੋਣਾ ਪੁਸ਼ਟੀ ਕਰੋ
115```
116 
117### ਬੈਂਕ API ਟੈਸਟਿੰਗ
118 
119```bash
120cd 7-bank-project/api
121npm run lint       # ਕੋਡ ਅੰਦਾਜ਼ ਸਮੱਸਿਆਵਾਂ ਦੀ ਜਾਂਚ ਕਰੋ
122node server.js     # ਬਿਨਾਂ ਗਲਤੀਆਂ ਦੇ ਸਰਵਰ ਸ਼ੁਰੂ ਹੋਣ ਦੀ ਜਾਂਚ ਕਰੋ
123```
124 
125### ਆਮ ਟੈਸਟਿੰਗ ਪਹੁੰਚ
126 
127- ਇਹ ਇੱਕ ਸਿੱਖਣਯੋਗ ਰਿਪੋਜ਼ਿਟਰੀ ਹੈ ਜਿਸ ਵਿੱਚ ਪੂਰਨ ਆਟੋਮੈਟਿਕ ਟੈਸਟ ਨਹੀਂ ਹਨ
128- ਮੈਨੁਅਲ ਟੈਸਟਿੰਗ ‘ਤੇ ਧਿਆਨ:
129  - ਕੋਡ ਉਦਾਹਰਣਾਂ ਬਿਨਾਂ ਗਲਤੀਆਂ ਚੱਲ ਰਹੇ ਹੋਣ
130  - ਦਸਤਾਵੇਜ਼ਾਂ ਵਿੱਚ ਲਿੰਕ ਠੀਕ ਕੰਮ ਕਰ ਰਹੇ ਹੋਣ
131  - ਪ੍ਰੋਜੈਕਟ ਬਿਲਡ ਸਫਲਤਾਪੂਰਵਕ ਹੋਣ
132  - ਉਦਾਹਰਣਾਂ ਵਧੀਆ ਪ੍ਰਥਾਵਾਂ ਦੀ ਪਾਲਣਾ ਕਰ ਰਹੇ ਹੋਣ
133 
134### ਪੂਰਵ-ਦਾਖਲਾ ਚੈੱਕ
135 
136- `package.json` ਵਾਲੇ ਫੋਲਡਰਾਂ ਵਿੱਚ `npm run lint` ਚਲਾਓ
137- ਮਾਰਕਡਾਊਨ ਲਿੰਕਾਂ ਦੀ ਸੰਪੂਰਨਤਾ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ
138- ਕੋਡ ਉਦਾਹਰਣ ਬ੍ਰਾਉਜ਼ਰ ਜਾਂ Node.js ਵਿੱਚ ਟੈਸਟ ਕਰੋ
139- ਅਨੁਵਾਦਾਂ ਦੀ ਸਠਿਕ ਰਚਨਾ ਬਰਕਰਾਰ ਰਹਿੰਦੀ ਹੈ ਜਾਂ ਨਹੀਂ ਚੈੱਕ ਕਰੋ
140 
141## ਕੋਡ ਸਟਾਈਲ ਨਿਰਦੇਸ਼
142 
143### JavaScript
144 
145- ਆਧੁਨਿਕ ES6+ ਵਾਕਯਾਂ ਨੂੰ ਵਰਤੋਂ
146- ਪ੍ਰਾਜੈਕਟਾਂ ਵਿੱਚ ਦਿੱਤੇ ਗਏ ESLint ਵਿਵਸਥਾਪਨ ਦੀ ਪਾਲਣਾ ਕਰੋ
147- ਸਿੱਖਣ ਦੀ ਸਪਸ਼ਟਤਾ ਲਈ ਮਾਇਨੇਵਾਲੇ ਵੈਰੀਅਬਲ ਅਤੇ ਫੰਕਸ਼ਨ ਨਾਮ ਵਰਤੋਂ
148- ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ ਧਾਰਨਾ ਸਮਝਾਉਣ ਵਾਲੇ ਟਿੱਪਣੀਆਂ ਜੋੜੋ
149- ਜਿੱਥੇ ਲਾਗੂ ਹੋਵੇ ਪ੍ਰੀਟੀਅਰ ਨਾਲ ਫਾਰਮੈਟ ਕਰੋ
150 
151### HTML/CSS
152 
153- ਸਮਾਂਤਾਰਕ HTML5 ਤੱਤ
154- ਰਿਸਪਾਂਸਿਵ ਡਿਜ਼ਾਇਨ ਨੀਤੀ
155- ਸਾਫ਼ ਸਿੱਧੇ ਕਲਾਸ ਨਾਂਮ
156- CSS ਤਕਨੀਕਾਂ ਸਿੱਖਾਉਂਦੀਆਂ ਟਿੱਪਣੀਆਂ
157 
158### Python
159 
160- PEP 8 ਸਟਾਈਲ ਧਾਰਾਵਾਂ
161- ਸਿੱਖਣ ਲਈ ਸਾਫ਼ ਕੋਡ ਉਦਾਹਰਣ
162- ਜਿੱਥੇ ਲਾਗੂ ਹੋਵੇ ਟਾਈਪ ਉਹ ਘੁੱਟਨ ਸਮੇਤ
163 
164### ਮਾਰਕਡਾਊਨ ਦਸਤਾਵੇਜ਼
165 
166- ਸਪਸ਼ਟ ਸਿਰਲੇਖਾਂ ਦੀ ਵਰਕਿਰਤਾ
167- ਭਾਸ਼ਾ ਨਾਲ ਕੋਡ ਬਲਾਕ
168- ਵਾਧੂ ਸਰੋਤਾਂ ਲਈ ਲਿੰਕ
169- `images/` ਫੋਲਡਰਾਂ ਵਿੱਚ ਸਕ੍ਰੀਨਸ਼ਾਟ ਅਤੇ ਚਿੱਤਰ
170- ਪਹੁੰਚਯੋਗਤਾ ਲਈ ਚਿੱਤਰਾਂ ਦਾ Alt ਟੈਕਸਟ
171 
172### ਫਾਇਲ ਸੰਗਠਨ
173 
174- ਲੈਸਨ ਕ੍ਰਮਵਾਰ ਨੰਬਰਿਤ (1-getting-started-lessons, 2-js-basics, ਆਦਿ)
175- ਹਰ ਪ੍ਰੋਜੈਕਟ ਵਿੱਚ `solution/` ਅਤੇ ਅਕਸਰ `start/` ਜਾਂ `your-work/` ਡਾਇਰੈਕਟਰੀਆਂ
176- ਪਾਠ-ਵਿਸ਼ੇਸ਼ `images/` ਫੋਲਡਰਾਂ ਵਿੱਚ ਚਿੱਤਰ ਸਟੋਰ ਹੁੰਦੇ ਹਨ
177- ਤਰਜਮੇ ਨੂੰ `translations/{language-code}/` ਵਿੱਚ ਸੰਗ੍ਰਹਿਤ ਕਰਨਾ
178 
179## ਬਿਲਡ ਅਤੇ ਡਿਪਲੋਇਮੈਂਟ
180 
181### ਕਵਿਜ਼ ਐਪ ਡਿਪਲੋਇਮੈਂਟ (Azure Static Web Apps)
182 
183quiz-app ਨੂੰ Azure Static Web Apps ਡਿਪਲੋਇਮੈਂਟ ਲਈ ਸੈਟ ਕੀਤਾ ਗਿਆ ਹੈ:
184 
185```bash
186cd quiz-app
187npm run build      # dist/ ਫੋਲਡਰ ਬਣਾਉਂਦਾ ਹੈ
188# ਮੈਨ branch 'ਤੇ push ਕਰਨ 'ਤੇ GitHub Actions ਵਰਕਫਲੋ ਰਾਹੀਂ ਡਿਪਲੌਏਂਡ ਕਰਦਾ ਹੈ
189```
190 
191Azure Static Web Apps ਸੰਰਚਨਾ:
192- **ਐਪ ਸਥਿਤੀ**: `/quiz-app`
193- **ਆਉਟਪੁੱਟ ਸਥਿਤੀ**: `dist`
194- **ਵਰਕਫਲੋ**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
195 
196### ਦਸਤਾਵੇਜ਼ PDF ਬਣਾਉਣਾ
197 
198```bash
199npm install                    # docsify-to-pdf ਨੂੰ ਇੰਸਟਾਲ ਕਰੋ
200npm run convert               # docs ਤੋਂ PDF ਬਣਾਓ
201```
202 
203### Docsify ਦਸਤਾਵੇਜ਼
204 
205```bash
206npm install -g docsify-cli    # ਡੌਕਸੀਫਾਈ ਨੂੰ ਗਲੋਬਲੀ ਇੰਸਟਾਲ ਕਰੋ
207docsify serve                 # ਲੋਕਲਹੋਸਟ:3000 'ਤੇ ਸਰਵ ਕਰੋ
208```
209 
210### ਪ੍ਰੋਜੈਕਟ-ਵਿਸ਼ੇਸ਼ ਬਿਲਡ
211 
212ਹਰ ਪ੍ਰੋਜੈਕਟ ਡਾਇਰੈਕਟਰੀ ਦਾ ਆਪਣਾ ਬਿਲਡ ਪ੍ਰਕਿਰਿਆ ਹੋ ਸਕਦਾ ਹੈ:
213- Vue ਪ੍ਰੋਜੈਕਟ: `npm run build` ਨਾਲ ਉਤਪਾਦਨ ਬੰਨਲ ਬਣਾਓ
214- ਸਟੈਟਿਕ ਪ੍ਰੋਜੈਕਟ: ਕੋਈ ਬਿਲਡ ਨਹੀਂ, ਸਿੱਧੇ ਫਾਇਲਾਂ ਸੇਵਾ ਕਰੋ
215 
216## ਪੂਲ ਰਿਕਵੇਸਟ ਨਿਯਮ
217 
218### ਸਿਰਲੇਖ ਫਾਰਮੈਟ
219 
220ਸਪਸ਼ਟ, ਵਰਣਨਾਤਮਕ ਸਿਰਲੇਖ ਜੋ ਬਦਲਾਅ ਦੇ ਖੇਤਰ ਨੂੰ ਦਰਸਾਉਂਦੇ ਹਨ:
221- `[Quiz-app] Add new quiz for lesson X`
222- `[Lesson-3] Fix typo in terrarium project`
223- `[Translation] Add Spanish translation for lesson 5`
224- `[Docs] Update setup instructions`
225 
226### ਲੋੜੀਂਦੇ ਚੈੱਕਸ
227 
228ਪੂਲ ਰਿਕਵੇਸਟ ਭੇਜਣ ਤੋਂ ਪਹਿਲਾਂ:
229 
2301. **ਕੋਡ ਕੁਆਲਿਟੀ**:
231   - ਪ੍ਰਭਾਵਿਤ ਪ੍ਰੋਜੈਕਟ ਡਾਇਰੈਕਟਰੀਆਂ ਵਿੱਚ `npm run lint` ਚਲਾਓ
232   - ਸਾਰੇ ਲਿੰਟ ਗਲਤੀਆਂ ਅਤੇ ਚੇਤਾਵਨੀ ਦੂਰ ਕਰੋ
233 
2342. **ਬਿਲਡ ਪੁਸ਼ਟੀ**:
235   - ਜੇ ਲਾਗੂ ਹੋਵੇ ਤਾਂ `npm run build` ਚਲਾਓ
236   - ਕੋਈ ਬਿਲਡ ਗਲਤੀ ਨਹੀਂ ਹੋਣ
237 
2383. **ਲਿੰਕ ਵੈਧਤਾ**:
239   - ਸਾਰੇ ਮਾਰਕਡਾਊਨ ਲਿੰਕ ਟੈਸਟ ਕਰੋ
240   - ਚਿੱਤਰ ਸੰਦਰਭਾਂ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ
241 
2424. **ਸਮੱਗਰੀ ਸਮੀਖਿਆ**:
243   - ਸਪੈਲਿੰਗ ਅਤੇ ਵਿਆਕਰਨ ਲਈ ਪ੍ਰੂਫਰੀਡ ਕਰੋ
244   - ਕੋਡ ਉਦਾਹਰਣ ਸਹੀ ਅਤੇ ਸਿੱਖਣਯੋਗ ਹੋਣ
245   - ਅਨੁਵਾਦਾਂ ਦਾ ਮੂਲ ਅਰਥ ਬਣਿਆ ਰਹੇ ਇਹ ਚੈੱਕ ਕਰੋ
246 
247### ਯੋਗਦਾਨ ਲੈਣ ਦੀਆਂ ਸ਼ਰਤਾਂ
248 
249- ਮਾਈਕ੍ਰੋਸਾਫਟ CLA (ਸਵੈਚਾਲਿਤ ਜਾਂਚ ਪਹਿਲੀ PR ‘ਤੇ) ਨੂੰ ਮਨਜ਼ੂਰ ਕਰੋ
250- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) ਦੀ ਪਾਲਣਾ ਕਰੋ
251- ਵਿਸਥਾਰ ਲਈ [CONTRIBUTING.md](./CONTRIBUTING.md) ਵੇਖੋ
252- ਜੇ ਲਾਗੂ ਹੋਵੇ ਤਾਂ PR ਵੇਰਵੇ ਵਿੱਚ ਮੁੱਦੇ ਨੰਬਰ ਦਰਜ ਕਰੋ
253 
254### ਸਮੀਖਿਆ ਪ੍ਰਕਿਰਿਆ
255 
256- PRs ਨੂੰ ਮੇਂਟੇਨਰਾਂ ਅਤੇ ਕਮਿਊਨਿਟੀ ਵੱਲੋਂ ਸਮੀਖਿਆ ਕੀਤੀ ਜਾਂਦੀ ਹੈ
257- ਸਿੱਖਣਯੋਗ ਸਪਸ਼ਟਤਾ ਪ੍ਰਾਥਮਿਕਤਾ ਹੈ
258- ਕੋਡ ਉਦਾਹਰਣ ਮੌਜੂਦਾ ਵਧੀਆ ਅਭਿਆਸਾਂ ਦੀ ਪਾਲਣਾ ਕਰਨੇ ਚਾਹੀਦੇ ਹਨ
259- ਅਨੁਵਾਦਾਂ ਦੀ ਸੁਨਿਸ਼ਚਿਤਤਾ ਅਤੇ ਸਾਂਸਕ੍ਰਿਤਿਕ ਉਚਿਤਤਾ ਲਈ ਸਮੀਖਿਆ
260 
261## ਅਨੁਵਾਦ ਸਿਸਟਮ
262 
263### ਸਵੈਚਾਲਿਤ ਅਨੁਵਾਦ
264 
265- GitHub Actions ਨਾਲ co-op-translator ਵਰਕਫਲੋ ਵਰਤਦਾ ਹੈ
266- 50+ ਭਾਸ਼ਾਵਾਂ ਵਿੱਚ ਸਵੈਚਾਲਿਤ ਤੌਰ 'ਤੇ ਅਨੁਵਾਦ ਕਰਦਾ ਹੈ
267- ਸੋ스 ਫਾਇਲਾਂ ਮੁੱਖ ਡਾਇਰੈਕਟਰੀਆਂ ਵਿੱਚ ਹਨ
268- ਅਨੁਵਾਦ ਕੀਤੀਆਂ ਫਾਇਲਾਂ `translations/{language-code}/` ਵਿੱਚ ਹਨ
269 
270### ਮੈਨੁਅਲ ਅਨੁਵਾਦ ਸੁਧਾਰ ਜੋੜਨਾ
271 
2721. `translations/{language-code}/` ਵਿੱਚ ਫਾਇਲ ਲੱਭੋ
2732. ਸੰਰਚਨਾ ਨੂੰ ਸੁਰੱਖਿਅਤ ਰੱਖਦਿਆਂ ਸੁਧਾਰ ਕਰੋ
2743. ਕੋਡ ਉਦਾਹਰਣ ਕੰਮਕਾਜ਼ ਹੁੰਦੇ ਰਹਿੰਦੇ ਹਨ ਇਹ ਯਕੀਨੀ ਬਣਾਓ
2754. ਕਿਸੇ ਵੀ ਸਥਾਨਕ ਕਵਿਜ਼ ਸਮੱਗਰੀ ਦੀ ਜਾਂਚ ਕਰੋ
276 
277### ਅਨੁਵਾਦ ਮੈਟਾ ਡੇਟਾ
278 
279ਅਨੁਵਾਦ ਕੀਤੀਆਂ ਫਾਇਲਾਂ metadata ਹੈੱਡਰ ਸ਼ਾਮਲ ਕਰਦੀਆਂ ਹਨ:
280```markdown
281<!--
282CO_OP_TRANSLATOR_METADATA:
283{
284  "original_hash": "...",
285  "translation_date": "...",
286  "source_file": "...",
287  "language_code": "..."
288}
289-->
290```
291 
292## ਡੀਬੱਗਿੰਗ ਅਤੇ ਸਮੱਸਿਆਵਾਂ ਦਾ ਨਿਵਾਰਣ
293 
294### ਆਮ ਸਮੱਸਿਆਵਾਂ
295 
296**ਕਵਿਜ਼ ਐਪ ਸ਼ੁਰੂ ਨਹੀਂ ਹੁੰਦਾ**:
297- Node.js ਵਰਜਨ ਚੈੱਕ ਕਰੋ (v14+ ਸਿਫਾਰਸ਼ੀ ਹੈ)
298- `node_modules` ਅਤੇ `package-lock.json` ਮਿਟਾਓ, ਫਿਰ `npm install` ਚਲਾਓ
299- ਪੋਰਟ ਟਕਰਾਅ ਚੈੱਕ ਕਰੋ (ਮੂਲ: Vite 5173 ਪੋਰਟ ਵਰਤਦਾ ਹੈ)
300 
301**API ਸਰਵਰ ਸ਼ੁਰੂ ਨਹੀਂ ਹੁੰਦਾ**:
302- Node.js ਵਰਜਨ ਨਿਰੀਖਣ ਕਰੋ (node >=10)
303- ਜੇ ਪੋਰਟ ਪਹਿਲਾਂ ਹੀ ਵਰਤਿਆ ਜਾ ਰਿਹਾ ਹੈ ਤਾਂ ਚੈੱਕ ਕਰੋ
304- ਸਾਰੀਆਂ ਡਿਪੈਂਡੈਂਸੀਜ਼ `npm install` ਨਾਲ ਇੰਸਟਾਲ ਹੋਈਆਂ ਹਨ ਜਾਂ ਨਹੀਂ
305 
306**ਬਰਾਊਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ ਲੋਡ ਨਹੀਂ ਹੁੰਦਾ**:
307- manifest.json ਢੰਗ ਨਾਲ ਫਾਰਮੈਟਡ ਹੈ ਜਾਂ ਨਹੀਂ ਜਾਂਚੋ
308- ਬਰਾਊਜ਼ਰ ਕਨਸੋਲ ਵਿੱਚ ਗਲਤੀਆਂ ਦੇਖੋ
309- ਵਰਤੇ ਜਾ ਰਹੇ ਬਰਾਊਜ਼ਰ ਲਈ ਵਿਸ਼ੇਸ਼ ਐਕਸਟੈਂਸ਼ਨ ਇੰਸਟਾਲੇਸ਼ਨ ਅਨੁਸਾਰ ਕੰਮ ਕਰੋ
310 
311**Python ਚੈਟ ਪ੍ਰੋਜੈਕਟ ਸਮੱਸਿਆਵਾਂ**:
312- OpenAI ਪੈਕੇਜ ਇੰਸਟਾਲ ਕਰੋ: `pip install openai`
313- GITHUB_TOKEN ਵਾਤਾਵਰਣ ਚਰ (environment variable) ਸੈੱਟ ਹੈ ਜਾਂ ਨਹੀਂ
314- GitHub ਮਾਡਲਜ਼ ਐਕਸੈਸ ਪਰਮਿਸ਼ਨਾਂ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ
315 
316**Docsify ਦਸਤਾਵੇਜ਼ ਸੇਵਾ ਨਹੀਂ ਕਰ ਰਿਹਾ**:
317- docsify-cli ਗਲੋਬਲ ਇੰਸਟਾਲ ਕਰੋ: `npm install -g docsify-cli`
318- ਰਿਪੋਜ਼ਿਟਰੀ ਰੂਟ ਡਾਇਰੈਕਟਰੀ ਤੋਂ ਚਲਾਓ
319- `docs/_sidebar.md` ਮੌਜੂਦ ਹੈ ਜਾਂ ਨਹੀਂ ਜਾਂਚੋ
320 
321### ਵਿਕਾਸ ਵਾਤਾਵਰਣ ਟਿਪਸ
322 
323- HTML ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ VS Code ਵਿੱਚ Live Server ਐਕਸਟੈਂਸ਼ਨ ਵਰਤੋਂ
324- ESLint ਅਤੇ Prettier ਐਕਸਟੈਂਸ਼ਨਾਂ ਨੂੰ ਅਨੁਕੂਲ ਫਾਰਮੈਟਿੰਗ ਲਈ ਇੰਸਟਾਲ ਕਰੋ
325- ਜਾਵਾਸਕ੍ਰਿਪਟ ਲਈ ਬਰਾਊਜ਼ਰ ਡਿਵੈਲਪਰ ਟੂਲਜ਼ ਵਰਤੋਂ
326- Vue ਪ੍ਰੋਜੈਕਟਾਂ ਲਈ Vue DevTools ਬਰਾਊਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ ਇੰਸਟਾਲ ਕਰੋ
327 
328### ਪ੍ਰਦਰਸ਼ਨ ਦੀਆਂ ਗੱਲਾਂ
329 
330- ਵੱਡੀ ਗਿਣਤੀ ਵਿੱਚ ਅਨੁਵਾਦਤ ਫਾਇਲਾਂ (50+ ਭਾਸ਼ਾਵਾਂ) ਦੀ ਵਜੇ ਨਾਲ ਪੂਰੇ ਕਲੋਨ ਵੱਡੇ ਹਨ
331- ਕੇਵਲ ਸਮੱਗਰੀ 'ਤੇ ਕੰਮ ਕਰ ਰਹੇ ਹੋ ਤਾਂ shallow clone ਵਰਤੋਂ: `git clone --depth 1`
332- ਅੰਗਰੇਜ਼ੀ ਸਮੱਗਰੀ ’ਤੇ ਕੰਮ ਕਰਦਿਆਂ ਅਨੁਵਾਦਾਂ ਨੂੰ ਖੋਜ ਤੋਂ ਬਾਹਰ ਰੱਖੋ
333- ਪਹਿਲੀ ਵਾਰੀ npm install ਅਤੇ Vite build ਦੇ ਕਾਰਨ ਬਿਲਡ ਪ੍ਰਕਿਰਿਆ ਧੀਮੀ ਹੋ ਸਕਦੀ ਹੈ
334 
335## ਸੁਰੱਖਿਆ ਦੀਆਂ ਗੱਲਾਂ
336 
337### ਵਾਤਾਵਰਣ ਚਰ
338 
339- API ਕੁੰਜੀਆਂ ਕਦੇ ਵੀ ਰਿਪੋਜ਼ਿਟਰੀ ਵਿੱਚ ਕਮਿੱਟ ਨਾ ਕਰੋ
340- `.env` ਫਾਇਲਾਂ ਵਰਤੋ (ਜੋ `.gitignore` ਵਿੱਚ ਹਨ)
341- ਲੋੜੀਂਦੇ ਵਾਤਾਵਰਣ ਚਰ ਨੂੰ ਪ੍ਰੋਜੈਕਟ README ਫਾਇਲਾਂ ਵਿੱਚ ਦਰਜ ਕਰੋ
342 
343### Python ਪ੍ਰੋਜੈਕਟ
344 
345- ਵਰਚੁਅਲ ਵਾਤਾਵਰਣ ਵਰਤੋ: `python -m venv venv`
346- ਡਿਪੇਂਡੈਂਸੀਜ਼ ਅਪਡੇਟ ਰੱਖੋ
347- GitHub ਟੋਕੇਨ ਨੂੰ ਘੱਟੋ ਘੱਟ ਲੋੜੀਂਦੇ ਅਧਿਕਾਰਾਂ ਨਾਲ ਵਰਤੋਂ
348 
349### GitHub ਮਾਡਲ ਐਕਸੈਸ
350 
351- GitHub ਮਾਡਲਾਂ ਲਈ ਪਰਸਨਲ ਐਕਸੈਸ ਟੋਕੇਨ (PAT) ਲੋੜੀਂਦੇ ਹਨ
352- ਟੋਕੇਨ ਵਾਤਾਵਰਣ ਚਰ ਵਜੋਂ ਰੱਖੋ
353- ਟੋਕੇਨ ਜਾਂ ਪ੍ਰਮਾਣ ਪੱਤਰ ਕਦੇ ਵੀ ਕਮਿੱਟ ਨਾ ਕਰੋ
354 
355## ਵਧੂ ਨੋਟਸ
356 
357### ਲਕੜਾਰਥ ਸੰਗ੍ਰਾਹਕ
358 
359- ਵੈੱਬ ਵਿਕਾਸ ਵਿੱਚ ਪੂਰਨ ਸ਼ੁਰੂਆਤੀ
360- ਵਿਦਿਆਰਥੀ ਅਤੇ ਖੁਦ ਸਿੱਖਣ ਵਾਲੇ
361- ਕਲਾਸਰੂਮਾਂ ਵਿੱਚ ਸਿਲੇਬਸ ਦਾ ਉਪਯੋਗ ਕਰਨ ਵਾਲੇ ਅਧਿਆਪਕ
362- ਸਮੱਗਰੀ ਪਹੁੰਚਯੋਗਤਾ ਅਤੇ ਕਦਮ-ਦਰ-ਕਦਮ ਕੌਸ਼ਲ ਵਿਕਾਸ ਲਈ ਤਿਆਰ ਕੀਤੀ ਗਈ ਹੈ
363 
364### ਸਿੱਖਣ ਦੀ ਦਾਰਸ਼ਨਿਕਤਾ
365 
366- ਪ੍ਰੋਜੈਕਟ-ਆਧਾਰਿਤ ਸਿੱਖਣ ਦੀ ਪਢ਼ਤਾਲ
367- ਮੁੜ-ਮੁੜ ਗਿਆਨ ਦੀ ਜਾਂਚ (ਕਵਿਜ਼)
368- ਹੱਥ-ਵਿੱਚ ਕੋਡਿੰਗ ਅਭਿਆਸ
369- ਅਸਲੀ ਦੁਨੀਆ ਦੇ ਉਦਾਹਰਣ
370- ਫਰੇਮਵਰਕਾਂ ਤੋਂ ਪਹਿਲਾਂ ਬੁਨਿਆਦੀ ਜਾਣਕਾਰੀ ’ਤੇ ਧਿਆਨ
371 
372### ਰਿਪੋਜ਼ਿਟਰੀ ਦਾ ਸੰਭਾਲ
373 
374- ਸਿੱਖਣ ਵਾਲਿਆਂ ਅਤੇ ਯੋਗਦਾਨਕਾਰਾਂ ਦੀ ਸਰਗਰਮ ਸਮੁਦਾਇ
375- ਡਿਪੈਂਡੈਂਸੀਜ਼ ਅਤੇ ਸਮੱਗਰੀ ਦਾ ਨਿਯਮਤ ਅੱਪਡੇਟ
376- ਮੈਨਟੇਨਰਾਂ ਵੱਲੋਂ ਮੁੱਦੇ ਅਤੇ ਗੱਲਬਾਤਨੂੰ ਨਿਗਰਾਨੀ
377- ਅਨੁਵਾਦਾਂ ਦੇ ਅੱਪਡੇਟ GitHub Actions ਰਾਹੀਂ ਆਟੋਮੈਟਿਕ
378 
379### ਸੰਬੰਧਤ ਸਰੋਤ
380 
381- [Microsoft Learn ਮੋਡਿਊਲ](https://docs.microsoft.com/learn/)
382- [ਵਿਦਿਆਰਥੀ ਹੋਬ ਸਰੋਤ](https://docs.microsoft.com/learn/student-hub/)
383- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) ਸਿੱਖਣ ਵਾਲਿਆਂ ਲਈ ਸੁਝਾਇਆ ਗਿਆ
384- ਵਾਧੂ ਕੋਰਸ: ਜਨਰੇਟਿਵ AI, ਡੇਟਾ ਸਾਇੰਸ, ML, IoT ਸਿਲੇਬਸ ਉਪਲਬਧ
385 
386### ਨਿਰਧਾਰਿਤ ਪ੍ਰੋਜੈਕਟਾਂ ਨਾਲ ਕੰਮ
387 
388ਵਿਸਥਾਰਿਤ ਨਿਰਦੇਸ਼ਾਂ ਲਈ ਹਰੇਕ ਪ੍ਰੋਜੈਕਟ README ਫਾਇਲਾਂ ਨੂੰ ਵੇਖੋ:
389- `quiz-app/README.md` - Vue 3 ਕਵਿਜ਼ অ্যਪਲੀਕੇਸ਼ਨ
390- `7-bank-project/README.md` - ਪ੍ਰਮਾਣਿਕਤਾ ਨਾਲ ਬੈਂਕਿੰਗ ਐਪਲੀਕੇਸ਼ਨ
391- `5-browser-extension/README.md` - ਬਰਾਊਜ਼ਰ ਐਕਸਟੈਂਸ਼ਨ ਵਿਕਾਸ
392- `6-space-game/README.md` - ਕੈਨਵਾਸ ਆਧਾਰਤ ਗੇਮ ਵਿਕਾਸ
393- `9-chat-project/README.md` - AI ਚੈਟ ਅਸਿਸਟੈਂਟ ਪ੍ਰੋਜੈਕਟ
394 
395### ਮੋਨੋਰੇਪੋ ਸੰਰਚਨਾ
396 
397ਇਹ ਪਾਰੰਪਰਿਕ ਮੋਨੋਰੇਪੋ ਨਹੀਂ ਹੈ ਪਰ ਇਸ ਵਿੱਚ ਬਹੁਤ ਸਾਰੇ ਸੁਤੰਤਰ ਪ੍ਰੋਜੈਕਟ ਹਨ:
398- ਹਰ ਪਾਠ ਖੁਦਮੁਖਤਿਆਰ ਹੈ
399- ਪ੍ਰੋਜੈਕਟਾਂ ਵਿੱਚ ਸਾਂਝੇ ਡਿਪੈਂਡੈਂਸੀਜ਼ ਨਹੀਂ ਹਨ
400- ਇਕ-ਦੂਜੇ ਉੱਤੇ ਪ੍ਰਭਾਵ ਨਾ ਪਾਉਂਦੇ ਹੋਏ ਵੱਖ-ਵੱਖ ਪ੍ਰੋਜੈਕਟਾਂ ’ਤੇ ਕੰਮ ਕਰੋ
401- ਪੂਰਾ ਸਿਲੇਬਸ ਅਨੁਭਵ ਲਈ ਸਾਰੀ ਰਿਪੋ ਕਲੋਨ ਕਰੋ
402 
403---
404 
405<!-- CO-OP TRANSLATOR DISCLAIMER START -->
406**ਅਸਵੀਕਾਰੋpetition**:  
407ਇਸ ਦਸਤਾਵੇਜ਼ ਦਾ ਅਨੁਵਾਦ AI ਅਨੁਵਾਦ ਸੇਵਾ [Co-op Translator](https://github.com/Azure/co-op-translator) ਦੀ ਵਰਤੋਂ ਨਾਲ ਕੀਤਾ ਗਿਆ ਹੈ। ਜਦੋਂ ਕਿ ਅਸੀਂ ਸ਼ੁੱਧਤਾ ਲਈ ਕੋਸ਼ਿਸ਼ ਕਰਦੇ ਹਾਂ, ਕਿਰਪਾ ਕਰਕੇ ਧਿਆਨ ਰੱਖੋ ਕਿ ਸਵਚਾਲਿਤ ਅਨੁਵਾਦਾਂ ਵਿੱਚ ਗਲਤੀਆਂ ਜਾਂ ਅਸੰਸ਼ੋਧਿਤੀਆਂ ਹੋ ਸਕਦੀਆਂ ਹਨ। ਇਸ ਦਾ ਮੂਲ ਦਸਤਾਵੇਜ਼ ਆਪਣੀ ਮੂਲ ਭਾਸ਼ਾ ਵਿੱਚ ਇਸਦਾ ਪ੍ਰਮਾਣਿਕ ਸਰੋਤ ਮੰਨਿਆ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ। ਮਹੱਤਵਪੂਰਣ ਜਾਣਕਾਰੀ ਲਈ ਵਿਸ਼ੇਸ਼ਗੀ ਮਨੁੱਖੀ ਅਨੁਵਾਦ ਦੀ ਸਿਫ਼ਾਰਸ਼ ਕੀਤੀ ਜਾਂਦੀ ਹੈ। ਅਸੀਂ ਇਸ ਅਨੁਵਾਦ ਦੀ ਵਰਤੋਂ ਤੋਂ ਉਪਜਣ ਵਾਲੀਆਂ ਕਿਸੇ ਵੀ ਗਲਤਫ਼ਹਮੀ ਜਾਂ ਗਲਤ ਵਿਵਿਚਾਰ ਲਈ ਜ਼ਿੰਮੇਵਾਰ ਨਹੀਂ ਹਾਂ।
408<!-- CO-OP TRANSLATOR DISCLAIMER END -->