@ -1,28 +1,28 @@
# AGENTS.md
## प्रोजेक्ट अवलोकन
## परियोजना अवलोकन
यह शुरुआती लोगों को वेब विकास के मूल सिद्धांत सिखाने के लिए एक शैक्षिक पाठ्यक्रम भंडार है। यह पाठ्यक्रम Microsoft Cloud Advocates द्वारा विकसित 12 सप्ताह का एक व्यापक कोर्स है, जिसमें JavaScript, CSS, और HTML को कवर करने वाले 24 हैंड्स-ऑन लेसन शामिल हैं।
यह शुरुआती लोगों के लिए वेब विकास के मूल सिद्धांतों को सिखाने के लिए एक शैक्षिक पाठ्यक्रम भंडार (रिपॉजिटरी) है। यह पाठ्यक्रम माइक्रोसॉफ्ट क्लाउड एडवोकेट्स द्वारा विकसित एक व्यापक 12-सप्ताह का कोर्स है, जिसमें JavaScript, CSS, और HTML को कवर करते हुए 24 व्यावहारिक पाठ शामिल हैं।
### मुख्य घटक
- ** शैक्षिक सामग्री**: परियोजना-आधारित मॉड्यूल में व्यवस्थित 24 संरचित लेसन
- ** व्यावहारिक परियोजनाएं**: टेरा रियम, टाइपिंग गेम, ब्राउज़र एक्सटेंशन, स्पेस गेम, बैंकिंग ऐप, कोड संपादक, और AI चैट सहायक
- ** इंटरैक्टिव क्विज़**: 48 क्विज़, प्रत्येक में 3 प्रश्न (प्री/पोस्ट-लेसन मूल्यांकन)
- ** शैक्षिक सामग्री**: परियोजना-आधारित मॉड्यूल में व्यवस्थित 24 संरचित पाठ
- ** व्यावहारिक परियोजनाएं**: टेररियम, टाइपिंग गेम, ब्राउज़र एक्सटेंशन, स्पेस गेम, बैंकिंग ऐप, कोड एडिटर, और AI चैट असिस्टेंट
- ** इंटरैक्टिव क्विज़**: प्रत्येक में 3 प्रश्नों के साथ 48 क्विज़ (पाठ से पहले/बाद मूल्यांकन)
- ** बहुभाषी समर्थन**: GitHub Actions के माध्यम से 50+ भाषाओं के लिए स्वचालित अनुवाद
- ** तकनीके ं**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI परियोजनाओं के लिए)
- ** प्रौद्योगिकिया ं**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI परियोजनाओं के लिए)
### वास्तुकल ा
### संरचन ा
- लेसन-आधारित संरचना के साथ शैक्षिक रिपॉजिटरी
- प्रत्येक लेसन फ़ोल्डर में README, कोड उदाहरण, और समाधान होते हैं
- अलग-अलग निर्देशिकाओं में स्वतंत्र परियोजनाएं (quiz-app, विभिन्न लेसन परियोजनाएं)
- GitHub Actions (co-op-translator) का उपयोग करने वाला अनुवाद प्रणाली
- Docsify द्वारा परोसी गई और PDF के रूप में उपलब्ध दस्तावेज़ीकरण
- शैक्षिक रिपॉजिटरी जो पाठ-आधारित संरचना पर आधारित है
- प्रत्येक पाठ फ़ोल्डर में README, कोड उदाहरण, और समाधान होते हैं
- अलग-अलग निर्देशिकाओं में स्वतंत्र परियोजनाएं (quiz-app, विभिन्न पाठ परियोजनाएं)
- GitHub Actions (co-op-translator) का उपयोग कर अनुवाद प्रणाली
- दस्तावेज़ीकरण Docsify के माध्यम से उपलब्ध और PDF के रूप में भी उपलब्ध
## सेटअप कमांड्स
## सेटअप कमांड
यह रिपॉजिटरी मुख्य रूप से शैक्षिक सामग्री की खपत के लिए है। विशिष्ट परियोजनाओं के साथ काम करने के लिए:
यह रिपॉजिटरी मुख्य रूप से शैक्षिक सामग्री के उपभोग के लिए है। विशिष्ट परियोजनाओं के साथ काम करने के लिए:
### मुख्य रिपॉजिटरी सेटअप
@ -36,19 +36,19 @@ cd Web-Dev-For-Beginners
```bash
cd quiz-app
npm install
npm run dev # विकास सर्वर प्रारंभ करें
npm run build # उत्पादन के लिए बनाए ं
npm run lint # ESLint चलाएं
npm run dev # विकास सर्वर शुरू करें
npm run build # उत्पादन के लिए निर्माण करे ं
npm run lint # ESLint चलाएँ
```
### बैंक प्रोजेक्ट API (Node.js + Express)
### बैंक परियोजना API (Node.js + Express)
```bash
cd 7-bank-project/api
npm install
npm start # एपीआई सर्वर शुरू करें
npm run lint # ESLint चलाएँ
npm run format # Prettier के साथ फ़ ॉर्मेट करें
npm run lint # ESLint चलाएं
npm run format # Prettier के साथ फॉर्मेट करें
```
### ब्राउज़र एक्सटेंशन परियोजनाएं
@ -64,10 +64,10 @@ npm install
```bash
cd 6-space-game/solution
npm install
# ब्राउज़र में index.html खोलें या Live Server का उपयोग करें
# ब्राउज़र में index.html खोलें या लाइव सर्वर का उपयोग करें
```
### चैट प्रोजेक्ट (Python Backend )
### चैट परियोजना (Python बैकएंड )
```bash
cd 9-chat-project/solution/backend/python
@ -80,22 +80,22 @@ python api.py
### सामग्री योगदानकर्ताओं के लिए
1. ** रिपॉजिटरी को अपने GitHub अकाउंट में फोर्क करें**
2. ** अपने फोर्क को लोकली क्लोन करें**
3. ** अपने परिवर्तनों के लिए नई शाखा बनाएं**
4. लेसन सामग्री या कोड उदाहरणों में परिवर्तन करें
5. संबंधित परियोजना निर्देशिकाओं में कोई भी को ड परिवर्तन परीक्षण करें
6. योगदान दिशानिर्देशों का पालन करते हुए पुल अनुरोध सबमिट करें
1. ** रिपॉजिटरी को फ़ॉर्क करें** अपने GitHub खाते पर
2. ** अपने फ़ॉर्क को स्थानीय रूप से क्लोन करें**
3. ** अपने बदलावों के लिए नई ब्रांच बनाएं**
4. पाठ सामग्री या कोड उदाहरणों में बदलाव करें
5. संबंधित परियोजना निर्देशिकाओं में कोड परिवर्तनों का परीक्षण करें
6. योगदान दिशानिर्देशों का पालन करते हुए पुल अनुरोध प्रस्तुत करें
### शिक्षार्थियों के लिए
1. रिपॉजिटरी को फो र्क या क्लोन करें
2. लेसन निर्देशिकाओं में क्रमबद्ध रूप से नेविगेट करे ं
3. प्रत्येक लेसन के README फ़ ाइल पढ़ें
4. प्री-लेसन क्विज़ https://ff-quizzes.netlify.app/web/ पर पूरा करें
5. लेसन फोल्डर्स में कोड उदाहरणों के माध्यम से काम करें
6. असाइनमेंट और चुनौतियां पूरी करें
7. पोस्ट-लेसन क्विज़ द ें
1. रिपॉजिटरी को फ़ॉ र्क या क्लोन करें
2. क्रमशः पाठ निर्देशिकाओं में जाए ं
3. प्रत्येक पाठ के README फ ाइल पढ़ें
4. https://ff-quizzes.netlify.app/web/ पर पूर्व-पाठ क्विज़ पूरा करें
5. पाठ फ़ोल्डरों में कोड उदाहरणों के साथ काम करें
6. असाइनमेंट और चुनौतियाँ पूरा करें
7. पोस्ट-पाठ क्विज़ ल ें
### लाइव विकास
@ -110,173 +110,173 @@ python api.py
```bash
cd quiz-app
npm run lint # कोड शैली की समस्याओं के लिए जांचें
npm run build # सत्यापित करें कि बिल्ड सफल हो ता है
npm run lint # कोड स्टाइल समस्याओं के लिए जांच कर ें
npm run build # सुनिश्चित करें कि निर्माण सफल हो जा ता है
```
### बैंक API परीक्षण
```bash
cd 7-bank-project/api
npm run lint # कोड स्टाइल समस्याओं के लिए जां च करें
node server.js # जांच ें कि सर्वर बिना त्रुटियों के शुरू होता है
npm run lint # कोड शैली की समस्याओं के लिए जाँ च करें
node server.js # पुष्टि कर ें कि सर्वर बिना त्रुटियों के शुरू होता है
```
### सामान्य परीक्षण दृष्टिकोण
- यह एक शैक्षिक रिपॉजिटरी है जिसमें व्यापक स्वचालित परीक्षण नहीं हैं
- मैनुअल परीक्षण पर ध्यान केंद्रित करता है :
- मैनुअल परीक्षण पर ध्यान केंद्रित:
- कोड उदाहरण बिना त्रुटि के चलना चाहिए
- दस्तावेज़ीकरण में लिंक सही तरीके से काम करें
- परियोजना निर्माण सफलतापूर्वक पूर्ण होना चाहिए
- उदाहरण सर्वोत्तम प्रथाओं का पालन करें
- दस्तावेज़ीकरण में लिंक सही काम करत े है ं
- परियोजना निर्माण सफलतापूर्वक पूरा होता है
- उदाहरणों में सर्वोत्तम प्रथाओं का पालन होता है
### प्री- सबमिशन जांच
### सबमिशन से पहले जांच
- package.json वाले निर्देशिकाओं में `npm run lint` चलाएं
- मार्कडाउन लिंक वैध हैं या नहीं जांच ें
- कोड उदाहरण ब्राउज़र या Node.js में टेस्ट करें
- जांचें कि अनुवाद संरचना बनाए रखे ं
- मार्कडाउन लिंक मान्य हैं यह सत्यापित कर ें
- ब्राउज़र या Node.js में कोड उदाहरणों का परीक्षण करें
- सुनिश्चित करें कि अनुवाद सही संरचना बनाए रखते है ं
## कोड शैली दिशानिर्देश
## कोड स्टाइल दिशानिर्देश
### JavaScript
- आधुनिक ES6+ सिंटैक्स का उपयोग करें
- परियोजनाओं में उपलब्ध मानक ESLint कॉन्फ़िगरेशन का पालन करें
- शैक्षिक स्पष्टता के लिए सार्थक वेरिएबल और फ़ंक्शन नामों का उपयोग करें
- शिक्षार्थियों के लिए अवधारणाओं की व्याख्या करने वाले टिप्पणियाँ जोड़ें
- जहां कॉन्फ़िगर हो वहां Prettier का उपयोग करें
- परियोजनाओं में प्रदान किए गए मानक ESLint विन्यास का पालन करें
- शैक्षिक स्पष्टता के लिए सार्थक चर और फ़ंक्शन नाम उपयोग करें
- शिक्षार्थियों के लिए अवधारणाओं को समझाने वाले टिप्पणियां जोड़ें
- जहां कॉन्फ़िगर हो Prettier का उपयोग करें
### HTML/CSS
- सेमा ंटिक HTML5 तत्व
- सेमंटिक HTML5 तत्व
- उत्तरदायी डिज़ाइन सिद्धांत
- स्पष्ट क्लास नामकरण कन्वेंश न
- शिक्षार्थियों के लिए CSS तकनीकों की व्याख्या करने वाली टिप्पणियाँ
- स्पष्ट क्लास नामकरण सम्मेल न
- शिक्षार्थियों के लिए CSS तकनीकों को समझाने वाली टिप्पणियां
### Python
- PEP 8 शैली दिशानिर्देश
- स्पष्ट, शैक्षिक कोड उदाहरण
- सीखने में सहायक टाइप संकेत
- जहां उपयोगी हो, टाइप हिन्ट्स
### Markdown दस्तावेज़ीकरण
### मार्कडाउन दस्तावेज़ीकरण
- स्पष्ट हेडिंग पदानुक्रम
- भाषा निर्दिष्ट कोड ब्लॉक्स
- भाषा निर्दिष्ट कोड ब्लॉक
- अतिरिक्त संसाधनों के लिंक
- `images/` निर्देशिकाओं में स्क्रीनशॉट और चित्र
- पहुँच के लिए चित्रों के लिए Alt पाठ
- `images/` निर्देशिकाओं में स्क्रीनशॉट और छवियां
- पहुंच योग्यता के लिए छवियों के लिए Alt टेक्स्ट
### फ़ाइल संगठन
- लेसन क्रमशः नंबर ित (1-getting-started-lessons, 2-js-basics, आदि)
- प्रत्येक परियोजना में `solution/` और अक्सर `start/` या `your-work/` निर्देशिकाएं
- चित्र लेसन-विशिष्ट `images/` फोल्डर में संग्रहि त
- पाठ क्रमशः क्रमांक ित (1-getting-started-lessons, 2-js-basics, आदि)
- प्रत्येक परियोजना में `solution/` और अक्सर `start/` या `your-work/` निर्देशिकाएं होती हैं
- छवियां पाठ-विशिष्ट `images/` फ़ोल्डरों में संग्रही त
- अनुवाद `translations/{language-code}/` संरचना में
## निर्माण और परिनियोजन
### क्विज़ ऐप परिनियोजन (Azure Static Web Apps)
quizz-app Azure Static Web Apps परिनियोजन के लिए कॉन्फ़िगर किया गया है:
क्विज़-ऐप Azure Static Web Apps परिनियोजन के लिए कॉन्फ़िगर है:
```bash
cd quiz-app
npm run build # dist/ फ़ोल्डर बनाता है
# मुख्य में पुश पर GitHub Actions वर्कफ़्लो के माध्यम से तैनात करता है
# मुख्य शाखा पर पुश करने पर GitHub Actions वर्कफ़्लो के माध्यम से तैनाती करता है
```
Azure Static Web Apps कॉन्फ़िगरेशन:
- ** ए प स्थान**: `/quiz-app`
- ** ऐ प स्थान**: `/quiz-app`
- ** आउटपुट स्थान**: `dist`
- ** कार्यप्रवाह **: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
- ** वर्कफ़्लो **: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### दस्तावेज़ीकरण PDF जनरेशन
### दस्तावेज़ीकरण PDF निर्माण
```bash
npm install # docsify-to-pdf इंस्टॉल करें
npm run convert # docs से PDF जनरेट करें
npm install # docsify-to-pdf स्थापित करें
npm run convert # docs से PDF बनाएँ
```
### Docsify दस्तावेज़ीकरण
```bash
npm install -g docsify-cli # Docsify को वैश्विक रूप से स्थापित करें
npm install -g docsify-cli # Docsify को ग्लोबली इंस्टॉल करें
docsify serve # localhost:3000 पर सेवा दें
```
### परियोजना-विशिष्ट निर्माण
प्रत्येक परियोजना निर्देशिका में अपना निर्माण प्रक्रिया हो सकती है:
- Vue परियोजनाएं: उत्पादन बंडल बनाने के लिए `npm run build`
- स्थिर परियोजनाएं: कोई निर्माण कदम नहीं, सीधे फ़ाइलें परोस ें
- Vue परियोजनाएं: `npm run build` उत्पाद बंडल बनाता है
- स्थैतिक परियोजनाएं: कोई निर्माण चरण नहीं, सीधे फाइलें सर्व कर ें
## पुल अनुरोध दिशानिर्देश
### शीर्षक प्रारूप
परिवर्तन क्षेत्र निर्दिष्ट करते हुए स्पष्ट, वर्णनात्मक शीर्षक का उपयोग करें:
- `[Quiz-app] लेसन X के लिए नया क्विज़ जोड़ें `
- `[Lesson-3] टेरारियम परियोजना में टाइपो ठीक करें `
- `[Translation] लेसन 5 के लिए स्पेनिश अनुवाद जोड़ें `
- `[Docs] सेटअप निर्देश अपडेट करें `
परिवर्तन के क्षेत्र को दर्शाने वाले स्पष्ट, वर्णनात्मक शीर्षक का उपयोग करें:
- `[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 `
### आवश्यक जांच
PR सबमिट करने से पहले:
PR प्रस्तुत करने से पहले:
1. ** कोड गुणवत्ता**:
- प्रभावित परियोजना निर्देशिकाओं में `npm run lint` चलाएं
- सभी लिंटिंग त्रुटियां और चेतावनियां ठीक करें
- सभी लिंटिंग त्रुटियों और चेतावनियों को ठीक करें
2. ** निर्माण सत्यापन**:
- लागू होने पर `npm run build` चलाएं
- कोई निर्माण त्रुटियां न हों
- यदि लागू हो तो `npm run build` चलाएं
- कोई निर्माण त्रुटि न हो
3. ** लिंक सत्यापन**:
- सभी मार्कडाउन लिंक टेस्ट कर ें
- छवि संदर्भ सही हों
- सभी मार्कडाउन लिंक जांच ें
- छवि संदर्भ काम करते हों
4. ** सामग्री समीक्षा**:
- वर्तनी और व्याकरण के लिए प्रूफरीड करें
- वर्तनी और व्याकरण ठीक करें
- कोड उदाहरण सही और शैक्षिक हों
- अनुवाद मूल अर्थ बनाए रखें
### योगदान आवश्यकताएं
- Microsoft CLA से सहमति (पहले PR पर स्वचालित जांच)
- Microsoft CLA से सहमत हों (पहले PR पर स्वचालित जांच)
- [Microsoft Open Source Code of Conduct ](https://opensource.microsoft.com/codeofconduct/ ) का पालन करें
- विस्तृत दिशानिर्देशों के लिए [CONTRIBUTING.md ](./CONTRIBUTING.md ) देखें
- यदि लागू हो तो PR विवरण में मुद्दा संख्या संदर्भित करें
- PR विवरण में समस्या नंबर का संदर्भ दें यदि लागू हो
### समीक्षा प्रक्रिया
- PR को रख रखावकर्ताओं और समुदाय द्वारा समीक्षा किया जाता है
- PRs रख- रखावकर्ताओं और समुदाय द्वारा समीक्षा की जाती हैं
- शैक्षिक स्पष्टता को प्राथमिकता दी जाती है
- कोड उदाहरण वर्तमान सर्वोत्तम प्रथाओं का पालन करें
- अनुवाद सटीकता और सांस्कृतिक उपयुक्तता के लिए समीक्षा की जाती है
- कोड उदाहरणों को वर्तमान सर्वोत्तम प्रथाओं का पालन करना चाहिए
- अनुवाद सटीकता और सांस्कृतिक उपयुक्तता के लिए समीक्षा किए जाते हैं
## अनुवाद प्रणाली
### स्वचालित अनुवाद
- co-op-translator वर्कफ़्लो के साथ GitHub Actions क ा उपयोग करता है
- 50+ भाषाओं में स्वचालित अनुवाद करता है
- GitHub Actions के साथ co-op-translator वर्कफ़्लो का उपयोग
- 50+ भाषाओं में स्वचालित अनुवाद
- स्रोत फाइलें मुख्य निर्देशिकाओं में
- अनुवादित फाइलें `translations/{language-code}/` निर्देशिकाओं में
### मैनुअल अनुवाद सुधार जोड़ना
1. `translations/{language-code}/` में फ़ाइल ढूंढ़ ें
1. `translations/{language-code}/` में फ़ाइल ढूंढें
2. संरचना बनाए रखते हुए सुधार करें
3. सुनिश्चित करें कि कोड उदाहरण कार्यशील हो ं
4. कोई स्थानीयकृत क्विज़ सामग्री हो तो उस का परीक्षण करें
3. सुनिश्चित करें कि कोड उदाहरण कार्यशील रहे ं
4. किसी भी स्थानीयकृत क्विज़ सामग्री का परीक्षण करें
### अनुवाद मेटाडेटा
अनुवादित फ़ ाइलों में मेटाडेटा हेडर शामिल होता है:
अनुवादित फाइलों में मेटाडेटा हेडर शामिल है:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -291,118 +291,118 @@ CO_OP_TRANSLATOR_METADATA:
## डिबगिंग और समस्या निवारण
### सामान्य समस्याएँ
### आम समस्याएं
**क्विज़ ऐप शुरू नहीं होता**:
- Node.js संस्करण जांचें (v14+ अनुशंसित)
- `node_modules` और `package-lock.json` हटाएं, फिर `npm install` चलाएं
- पोर्ट संघर्ष की जाँ च करें (डिफ़ॉल्ट: Vite पोर्ट 5173 का उपयोग करता है)
- पोर्ट संघर्षों की जां च करें (डिफ़ॉल्ट: Vite पोर्ट 5173 उपयोग करता है)
**API सर्वर शुरू नहीं होता**:
- Node.js संस्करण न्यूनतम ज़रूरतें पूरी करता है या नहीं ज ांचें (node >=10)
- जांचें कि पोर्ट पहले से उपयोग में तो नहीं
- सभी निर्भरताओं को `npm install` के साथ स्थापित करें
- Node.js संस्करण न्यूनतम जांचें (node >=10)
- जांचें कि पोर्ट पहले से उपयोग में न हो
- सभी निर्भरताएं `npm install` के साथ स्थापित हैं यह सुनिश्च ित करें
**ब्राउज़र एक्सटेंशन लोड नहीं होती **:
- manifest.json ठीक से फॉर्मेट किया गया है या नहीं जांचें
**ब्राउज़र एक्सटेंशन लोड नहीं होता **:
- सुनिश्चित करें कि manifest.json सही प्रारूप में है
- ब्राउज़र कंसोल में त्रुटियाँ देखें
- ब्राउज़र-विशिष्ट एक्सटेंशन इंस्टॉलेशन निर्देशों का पालन करें
**Python चैट प्रोजेक्ट समस्याएं**:
- सुनिश्चित करें OpenAI पैकेज इंस्टॉल है : `pip install openai`
- GITHUB_TOKEN पर्यावरण चर सेट है
**Python चैट परियोजना समस्याएं**:
- OpenAI पैकेज स्थापित करें : `pip install openai`
- जांचें कि GITHUB_TOKEN पर्यावरण चर सेट है
- GitHub Models एक्सेस अनुमतियाँ जांचें
**Docsify दस्तावेज़ सेवा नहीं दे रह ा**:
- docsify-cli ग्लोबली इंस्टॉल करें: `npm install -g docsify-cli`
**Docsify दस्तावेज़ सेवा नहीं करत ा**:
- docsify-cli वैश्विक रूप से स्थापित करें: `npm install -g docsify-cli`
- रिपॉजिटरी रूट निर्देशिका से चलाएं
- जांचें कि `docs/_sidebar.md` फ़ाइल मौजूद है
- जांचें कि `docs/_sidebar.md` मौजूद है
### विकास पर्य ावरण सुझाव
### विकास वात ावरण सुझाव
- HTML परियोजनाओं के लिए VS Code में Live Server एक्सटेंशन का उपयोग करें
- संगत स्वरूपण के लिए ESLint और Prettier एक्सटेंशन इंस्टॉल करें
- जावास्क्रिप्ट डिबगिंग के लिए ब्राउज़र DevTools का उपयोग करें
- Vue परियोजनाओं के लिए Vue DevTools ब्राउज़र एक्सटेंशन इंस्टॉल करें
- सुस ंगत स्वरूपण के लिए ESLint और Prettier एक्सटेंशन स्थापित करें
- JavaScript डिबगिंग के लिए ब्राउज़र DevTools का उपयोग करें
- Vue परियोजनाओं के लिए Vue DevTools ब्राउज़र एक्सटेंशन स्थापित करें
### प्रदर्शन विचार
- बड़ी संख्या में अनुवादित फाइलें (50+ भाषाएँ) होने से पूर्ण क्लोन बड़े होते हैं
- केवल सामग्री पर काम करने पर shallow clone का उपयोग करें: `git clone --depth 1`
- अंग्रेज़ी सामग्री पर काम करते समय अनुवादों को खोज से बाहर रखें
- पहला रन (npm install, Vite निर्माण) धीमा हो सकता है
- अनुवादित फाइलों की संख्या अधिक (50+ भाषाएँ) होने के कारण पूर्ण क्लोन बड़े होते हैं
- केवल सामग्री पर काम करने के लिए शैलो क्लोन का उपयोग करें: `git clone --depth 1`
- अंग्रेज़ी सामग्री पर काम करते समय अनुवादों को खोजों से बाहर रखें
- पहले रन पर निर्माण प्रक्रियाएं धीमी हो सकती हैं (npm install, Vite निर्माण)
## सुरक्षा विचार
### पर्यावरण चर
- API कुंजी कभी भी रिपॉजिटरी में कमिट न करें
- `.env` फाइलों का उपयोग करें (पहले से `.gitignore` में शामिल )
- आवश्यक पर्यावरण चर परियोजना README में दस्तावेजित करें
- API कुंजियाँ कभी भी रिपॉजिटरी में कमिट न करें
- `.env` फ़ ाइलों का उपयोग करें (जो `.gitignore` में शामिल हैं )
- परियोजना README में आवश्यक पर्यावरण वेरिएबल दस्तावेज़ ित करें
### Python परियोजनाएं
- वर्चुअल एनवायरनमेंट का उपयोग करें: `python -m venv venv`
- वर्चुअल पर्यावरण का उपयोग करें: `python -m venv venv`
- निर्भरताओं को अपडेट रखें
- GitHub टोकन न्यूनतम आवश्यक अनुमतियाँ रखे ं
- GitHub टोकन में न्यूनतम आवश्यक अनुमतियां होनी चाहिए
### GitHub Models एक्सेस
- GitHub Models के लिए Personal Access Tokens (PAT) आवश्यक
- टोकन पर्यावरण चरों के रूप में संग ्रहीत करें
- टोकन या क्रेडेंशियल कभी कमिट न करें
- GitHub Models के लिए व्यक्तिगत एक्सेस टोकन (PAT) आवश्यक
- टोकन को पर्यावरण चर के रूप में स्टो र करें
- टोकन या प्रमाणीकरण जानकारी कभी कमिट न करें
## अतिरिक्त नोट्स
### लक्षित दर्शक
- वेब विकास के पूर्ण शुरुआत करने वाले
- छात्र और स्व-अध्ययनकर्ता
- कक्षाओं में पाठ्यक्रम का उपयोग करने वाले शिक्षक
- सामग्री पहुँचनीयता और धीरे-धीरे कौशल निर्माण के लिए डिज़ाइन की गई है
- वेब विकास के पूर्ण शुरुआती
- छात्र और स्व-शिक्षार्थी
- शिक्षक जो कक्षाओं में पाठ्यक्रम का उपयोग करते हैं
- सामग्री पहुँच योग्यता और क्रमिक कौशल निर्माण के लिए डिज़ाइन की गई है
### शैक्षिक दर्शन
- परियोजना-आधारित शिक्षण दृष्टिकोण
- बार-बार ज्ञान जांच (क्विज़)
- हाथों-हाथ कोडिंग अभ्यास
- व्यावहारिक कोडिंग अभ्यास
- वास्तविक दुनिया के अनुप्रयोग उदाहरण
- फ्रेमवर्क से पहले मूल बाते ं पर ध्यान केंद्रित
- फ्रेमवर्क से पहले मूल सिद्धांतो ं पर ध्यान केंद्रित
### रिपॉजिटरी रखरखाव
### रिपॉजिटरी देखरेख
- सक्रिय शिक्षार्थी और योगदानकर्ता समुदाय
- निर्भरताओं और सामग्री का नियमित अपडेट
- मुद्दों और चर्चाओं पर रखरखावकर्ताओं द्वारा निगरानी
- अनुवाद अपडेट GitHub Actions द्वारा स्वचालित
- डेपेंडेंसी और सामग्री का नियमित अपडेट
- मुद्दों और चर्चाओं की मॉनिटरिंग रख-रखाव टीम द्वारा
- अनुवाद अपडेट GitHub Actions के द्वारा स्वचालित
### संबंधित संसाधन
- [Microsoft Learn modules ](https://docs.microsoft.com/learn/ )
- [Student Hub resources ](https://docs.microsoft.com/learn/student-hub/ )
- शिक्षार्थियों के लिए सिफारिश की गई [GitHub Copilot ](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot )
- अतिरिक्त कोर्स : जनरेटिव AI, डेटा साइंस, ML, IoT पाठ्यक्रम उपलब्ध
- [GitHub Copilot ](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot ) शिक्षार्थियों के लिए अनुशंसित
- अतिरिक्त पाठ्यक्रम : जनरेटिव AI, डेटा साइंस, ML, IoT पाठ्यक्रम उपलब्ध
### विशिष्ट परियोजनाओं के साथ काम करना
व्यक्तिगत परियोजनाओं के विस्तृत निर्देशों के लिए, निम्न README फ़ाइल देखें:
व्यक्तिगत परियोजनाओं पर विस्तृत निर्देशों के लिए, संबंधित 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 चैट सहायक परियोजना
- `6-space-game/README.md` - कैनवास आधारित गेम विकास
- `9-chat-project/README.md` - AI चैट असिस्टेंट परियोजना
### मोनोरि पो संरचना
### मुनोरे पो संरचना
यह पारंपरिक मोनोरिपो नहीं है, यह रिपॉजिटरी कई स्वतंत्र परियोजनाओं को शामिल करता है :
- प्रत्येक लेसन स्वतंत्र है
- परियोजनाएं निर्भरताएं साझा नहीं करतीं
- व्यक्तिगत परियोजनाओं पर बिना दूसरे प्रभावित हुए काम करें
- पूरा पाठ्यक्रम अनुभव के लिए पूरी रिपॉजिटरी क्लोन करें
यह पारंपरिक मुनोरेपो नहीं है, लेकिन इस रिपॉजिटरी में कई स्वतंत्र परियोजनाएं हैं :
- प्रत्येक पाठ स्वतंत्र है
- परियोजनाओं के बीच निर्भरता साझा नहीं होती
- एक परियोजना पर काम करते हुए अन्य प्रभावित नहीं होते
- पूरी पाठ्यक्रम अनुभव के लिए पूरी रिपॉजिटरी क्लोन करें
---
<!-- CO - OP TRANSLATOR DISCLAIMER START -->
**अस्वीकरण**:
यह दस्तावेज़ AI अनुवाद सेवा [Co-op Translator ](https://github.com/Azure/co-op-translator ) का उपयोग करके अनू दित किया गया है। जबकि हम सटीकता के लिए प्रयास क रते हैं, कृपया ध्यान दें कि स्वचालि त अनुवादों में त्रुटियाँ या अशुद्ध ियाँ हो सकती हैं। मूल दस्तावेज़ अपनी मूल भाषा में ही प्रामाणिक स्रोत माना जाना चाहिए। महत्वपूर्ण जानकारी के लिए पेशेवर मानवीय अनुवाद की सिफारिश क ी जाती है। इस अनुवाद के उपयोग से उत्पन्न किसी भी गलतफहमी या मिसइंटरप्रिटेशन के लिए हम जिम्मेदार नहीं हैं।
यह दस्तावेज़ [Co-op Translator ](https://github.com/Azure/co-op-translator ) एआई अनुवाद सेवा का उपयोग करके अनुवा दित किया गया है। जबकि हम सटीकता के लिए प्रयासरत हैं, कृपया ध्यान दें कि स्वत: अनुवादों में त्रुटियां या गलत ियाँ हो सकती हैं। मूल दस्तावेज़ अपनी मूल भाषा में ही प्राधिकृत स्रोत माना जाना चाहिए। महत्वपूर्ण जानकारी के लिए, पेशेवर मानव अनुवाद की सलाह द ी जाती है। इस अनुवाद के उपयोग से उत्पन्न किसी भी गलतफहमी या गलत व्याख्या के लिए हम उत्तरदायी नहीं हैं।
<!-- CO - OP TRANSLATOR DISCLAIMER END -->
localizeflow[bot]
2 weeks ago