AGENTS.md

1# AGENTS.md
2 
3## प्रकल्पाचा आढावा
4 
5हा वेब विकास मूलतत्त्वे शिकवण्यासाठी सुरुवातीच्या स्तरासाठी शैक्षणिक अभ्यासक्रम संग्रह आहे. हा अभ्यासक्रम Microsoft Cloud Advocates यांनी विकसित केलेला एक सर्वसमावेशक १२ आठवड्यांचा कोर्स आहे, ज्यामध्ये JavaScript, CSS आणि HTML या विषयांवर २४ प्रत्यक्ष शिकण्याच्या धड्यांचा समावेश आहे.
6 
7### मुख्य घटक
8 
9- **शैक्षणिक सामग्री**: प्रकल्प-आधारित मॉड्यूलमध्ये आयोजित २४ संरचित धडे
10- **प्रायोगिक प्रकल्प**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, आणि AI Chat Assistant
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 उघडा किंवा Live Server वापरा
68```
69 
70### चॅट प्रकल्प (Python Backend)
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- **प्रश्नमंजुषा अ‍ॅप**: `npm run dev` quiz-app डिरेक्टरीमध्ये चालवा
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- Markdown लिंक वैध आहेत का तपासा
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### Markdown दस्तऐवजीकरण
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# मुख्य ब्रांचवर 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    # 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] 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 
228PR सादर करण्यापूर्वी:
229 
2301. **कोड गुणवत्ता**:
231   - प्रभावित प्रकल्प डिरेक्टरीजमध्ये `npm run lint` चालवा
232   - सर्व लिंटिंग त्रुटी व चेतावण्या दुरुस्त करा
233 
2342. **बिल्ड तपासणी**:
235   - लागू असल्यास `npm run build` चालवा
236   - बिल्ड त्रुटी नाही याची खात्री करा
237 
2383. **लिंक पुष्टीकरण**:
239   - सर्व markdown लिंक तपासा
240   - प्रतिमा संदर्भ कार्यरत आहेत का तपासा
241 
2424. **सामग्री पुनरावलोकन**:
243   - स्पेलिंग आणि व्याकरण तपासा
244   - कोड उदाहरणे बरोबर आणि शैक्षणिक आहेत याची खात्री करा
245   - भाषांतरांमध्ये मूळ अर्थ जपला गेला आहे का तपासा
246 
247### योगदान आवश्यकता
248 
249- Microsoft CLA सह सहमती (पहिल्या PR वर स्वयंचलित तपासणी)
250- [Microsoft Open Source कोड ऑफ कंडक्ट](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- co-op-translator workflow सह GitHub Actions वापरतो
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- फक्त सामग्रीवर काम करत असल्यास शालो क्लोन वापरा: `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 Models प्रवेश
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 modules](https://docs.microsoft.com/learn/)
382- [Student Hub resources](https://docs.microsoft.com/learn/student-hub/)
383- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) शिकणाऱ्यांसाठी शिफारस
384- अतिरिक्त कोर्सेस: Generative AI, Data Science, 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**अस्वीकरण**:
407हे दस्तऐवज AI अनुवाद सेवा [Co-op Translator](https://github.com/Azure/co-op-translator) वापरून अनुवादित करण्यात आले आहे. आम्ही अचूकतेसाठी प्रयत्नशील आहोत, परंतु कृपया लक्षात घ्या की स्वयंचलित अनुवादांमध्ये चुका किंवा असत्यता असू शकतात. मूळ दस्तऐवज त्याच्या स्थानिक भाषेत अधिकृत स्त्रोत मानला गेला पाहिजे. महत्त्वाची माहिती असलेल्या बाबतीत व्यावसायिक मानवी अनुवादाची शिफारस केली जाते. या अनुवादाच्या वापरामुळे उद्भवणाऱ्या कोणत्याही गैरसमजुती किंवा चुकीच्या समजुतीसाठी आम्ही जबाबदार नाही.
408<!-- CO-OP TRANSLATOR DISCLAIMER END -->