AGENTS.md

1# AGENTS.md
2 
3## परियोजना अवलोकन
4 
5यो शुरुआतीहरूलाई वेब विकासका आधारहरू सिकाउन बनाइएको शैक्षिक पाठ्यक्रम भण्डार हो। यो पाठ्यक्रम माइक्रोसफ्ट क्लाउड एड्भोकेटहरूले विकास गरेको १२ हप्ताको व्याप्त छ, जसमा २४ अभ्यासात्मक पाठहरू छन् जसले JavaScript, CSS, र HTML कभर गर्दछ।
6 
7### प्रमुख अङ्गहरू
8 
9- **शैक्षिक सामग्री**: २४ संरचित पाठहरू परियोजना-आधारित मोड्युलहरूमा व्यवस्थित
10- **व्यावहारिक परियोजनाहरू**: टेरारियम, टाइपिङ खेल, ब्राउजर एक्सटेन्सन, स्पेस गेम, बैंकिङ एप, कोड सम्पादक, र AI च्याट सहायक
11- **इन्टरऐक्टिभ क्विजहरू**: प्रत्येकमा ३ प्रश्न सहित ४८ क्विजहरू (पाठभन्दा पहिले/पछि मूल्याङ्कन)
12- **धेरै भाषाहरूको समर्थन**: GitHub Actions मार्फत ५०+ भाषाहरूमा स्वचालित अनुवाद
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          # API सर्भर सुरु गर्नुहोस्
50npm run lint       # ESLint चलाउनुहोस्
51npm run format     # Prettier सँग फर्म्याट गर्नुहोस्
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# ब्राउजरमा index.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` चलाउनुहोस् (पोर्ट ३०००)
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- जहाँ कन्फिगर गरिएको हो त्यहाँ Prettier द्वारा फर्म्याट गर्नुहोस्
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 
183क्विज एप Azure Static Web Apps परिनियोजनका लागि कन्फिगर गरिएको छ:
184 
185```bash
186cd quiz-app
187npm run build      # dist/ फोल्डर सिर्जना गर्दछ
188# main मा पुश गर्दा GitHub Actions workflow मार्फत डिप्लोय गर्दछ
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    # Docsify लाई विश्वव्यापी रूपमा इन्स्टल गर्नुहोस्
207docsify serve                 # localhost:3000 मा सेवा गर्नुहोस्
208```
209 
210### परियोजना-विशिष्ट निर्माणहरू
211 
212हरेक परियोजनाले सायद आफ्नो निर्माण प्रक्रिया हुन सक्छ:
213- Vue परियोजनाहरू: `npm run build` ले उत्पादन बन्डलहरू बनाउँछ
214- स्थिर परियोजनाहरू: कुनै निर्माण चरण हुँदैन, फाइलहरू सिधै सेवा गरिन्छ
215 
216## पुल अनुरोध निर्देशनहरू
217 
218### शीर्षक ढाँचा
219 
220परिवर्तनको क्षेत्र वर्णन गर्ने स्पष्ट, वर्णनात्मक शीर्षकहरू प्रयोग गर्नुहोस्:
221- `[Quiz-app] पाठ X को लागि नयाँ क्विज थप्नुहोस्`
222- `[Lesson-3] टेरारियम परियोजनामा टाइपो फिक्स गर्नुहोस्`
223- `[Translation] पाठ ५ का लागि स्पेनिश अनुवाद थप्नुहोस्`
224- `[Docs] सेटअप निर्देशनहरू अपडेट गर्नुहोस्`
225 
226### आवश्यक जाँचहरू
227 
228PR पठाउनु अघि:
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- Microsoft 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- PR समीक्षा संरक्षकहरू र समुदायद्वारा गरिन्छ
257- शैक्षिक स्पष्टतालाई प्राथमिकता दिइन्छ
258- कोड उदाहरणहरूले वर्तमान उत्कृष्ट अभ्यासहरू अनुसरण गर्नुपर्छ
259- अनुवादहरू सटीकता र सांस्कृतिक उपयुक्तता अनुसार समीक्षा गरिन्छ
260 
261## अनुवाद प्रणाली
262 
263### स्वचालित अनुवाद
264 
265- GitHub Actions र co-op-translator वर्कफ्लो प्रयोग गर्दछ
266- ५०+ भाषाहरूमा स्वतः अनुवाद गर्छ
267- मुख्य निर्देशिकाहरूमा स्रोत फाइलहरू
268- अनुवादित फाइलहरू `translations/{language-code}/` निर्देशिकामा राखिएको
269 
270### म्यानुअल अनुवाद सुधारहरू थप्ने
271 
2721. `translations/{language-code}/` मा फाइल खोज्नुहोस्
2732. संरचना जोगाउँदै सुधारहरू गर्नुहोस्
2743. कोड उदाहरणहरू कार्यशील अवस्थामा राख्नुहोस्
2754. स्थानीयकृत क्विज सामग्री परीक्षण गर्नुहोस्
276 
277### अनुवाद मेटाडाटा
278 
279अनुवादित फाइलहरूमा मेटाडाटा हेडर समावेश हुन्छ:
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 वातावरण चर सेट गरिएको छ
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- JavaScript डिबगिङका लागि ब्राउजर DevTools प्रयोग गर्नुहोस्
326- Vue परियोजनाहरूका लागि Vue DevTools ब्राउजर एक्सटेन्सन स्थापना गर्नुहोस्
327 
328### प्रदर्शन विचारहरू
329 
330- ठूलो संख्यामा अनुवादित फाइलहरू (५०+ भाषाहरू) हुँदा पूर्ण क्लोनहरू ठूला हुन्छन्
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विशिष्ट परियोजनाहरूका लागि विस्तृत निर्देशनहरू हेर्नुहोस्:
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**अस्वीकरण**:
407यस कागजातलाई AI अनुवाद सेवा [Co-op Translator](https://github.com/Azure/co-op-translator) प्रयोग गरेर अनुवाद गरिएको हो। हामी शुद्धताका लागि प्रयास गर्छौं, तर कृपया जानकार रहनुहोस् कि स्वचालित अनुवादमा त्रुटि वा गलत जानकारी हुनसक्छ। मूल कागजात यसको स्थानीय भाषामा नै आधिकारिक स्रोत मानिनुपर्छ। महत्वपूर्ण जानकारीका लागि व्यावसायिक मानव अनुवादको सिफारिस गरिन्छ। यस अनुवादको प्रयोगबाट उत्पन्न हुने कुनै पनि गलत बुझाइ वा व्याख्याका लागि हामी जवाफदेही हुनेछैनौं।
408<!-- CO-OP TRANSLATOR DISCLAIMER END -->