Two files, one repository
microsoft/Web-Dev-For-Beginners ships 1 format across 40 indexed files. The question worth asking is whether the second one says anything the first does not.
| Dimension | Shared | Only in A | Only in B | Overlap |
|---|---|---|---|---|
| Sections | 2 | 57 | 11 | 3% |
| Commands | 14 | 0 | 0 | 100% |
| Section tags | 5 | 10 | 0 | 33% |
What each file covers
Sections
2 shared · 57 only in A · 11 only in B- − Project Overview
- − Key Components
- − Architecture
- − Setup Commands
- − Main Repository Setup
- − Quiz App Setup (Vue 3 + Vite)
- − Bank Project API (Node.js + Express)
- − Browser Extension Projects
- − Follow browser-specific extension loading instructions
- − Space Game Projects
- − Open index.html in browser or use Live Server
- − Chat Project (Python Backend)
- − Set GITHUB_TOKEN environment variable
- − Development Workflow
- − For Content Contributors
- − For Learners
- − Live Development
- − Testing Instructions
- − Quiz App Testing
- − Bank API Testing
- − General Testing Approach
- − Pre-submission Checks
- − Code Style Guidelines
- − JavaScript
- − Python
- − Markdown Documentation
- − File Organization
- − Build and Deployment
- − Quiz App Deployment (Azure Static Web Apps)
- − Deploys via GitHub Actions workflow on push to main
- − Documentation PDF Generation
- − Docsify Documentation
- − Project-specific Builds
- − Pull Request Guidelines
- − Title Format
- − Required Checks
- − Contribution Requirements
- − Review Process
- − Translation System
- − Automated Translation
- − Adding Manual Translation Improvements
- − Translation Metadata
- − Debugging and Troubleshooting
- − Common Issues
- − Development Environment Tips
- − Performance Considerations
- − Security Considerations
- − Environment Variables
- − Python Projects
- − GitHub Models Access
- − Additional Notes
- − Target Audience
- − Educational Philosophy
- − Repository Maintenance
- − Related Resources
- − Working with Specific Projects
- − Monorepo Structure
- + मोनोरिपॉ संरचना
- + क्विज़ ऐप सेटअप (Vue 3 + Vite)
- + बैंक प्रोजेक्ट API (Node.js + Express)
- + index.html को ब्राउज़र में खोलें या लाइव सर्वर का उपयोग करें
- + चैट प्रोजेक्ट (Python Backend)
- + GITHUB_TOKEN पर्यावरण चर सेट करें
- + बैंक API परीक्षण
- + क्विज़ ऐप तैनाती (Azure Static Web Apps)
- + मुख्य पर पुश करने पर GitHub Actions वर्कफ़्लो के माध्यम से डिप्लॉय करता है
- + प्रलेखन PDF निर्माण
- + GitHub मॉडल्स एक्सेस
- AGENTS.md
- HTML/CSS
Commands
14 shared · 0 only in A · 0 only in B- git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
- npm install
- npm run dev
- npm run build
- npm run lint
- npm start
- npm run format
- pip install openai
- python api.py
- node server.js
- npm run convert
- npm install -g docsify-cli
- git clone --depth 1
- python -m venv venv
Section tags
5 shared · 10 only in A · 0 only in B- − test
- − code-style
- − architecture
- − git-pr
- − security
- − performance
- − monorepo
- − do-not
- − agent-behaviour
- − docs
- setup
- build
- lint-format
- api
- ui
Line diff
microsoft/Web-Dev-For-Beginners · AGENTS.md
@@ −1 @@
1# AGENTS.md
2
3## Project Overview
4
5This is an educational curriculum repository for teaching web development fundamentals to beginners. The curriculum is a comprehensive 12-week course developed by Microsoft Cloud Advocates, featuring 24 hands-on lessons covering JavaScript, CSS, and HTML.
6
7### Key Components
8
9- **Educational Content**: 24 structured lessons organized into project-based modules
10- **Practical Projects**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, and AI Chat Assistant
11- **Interactive Quizzes**: 48 quizzes with 3 questions each (pre/post-lesson assessments)
12- **Multi-language Support**: Automated translations for 50+ languages via GitHub Actions
13- **Technologies**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (for AI projects)
14
15### Architecture
16
17- Educational repository with lesson-based structure
18- Each lesson folder contains README, code examples, and solutions
19- Standalone projects in separate directories (quiz-app, various lesson projects)
20- Translation system using GitHub Actions (co-op-translator)
21- Documentation served via Docsify and available as PDF
22
23## Setup Commands
24
25This repository is primarily for educational content consumption. For working with specific projects:
26
27### Main Repository Setup
28
29```bash
30git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
31cd Web-Dev-For-Beginners
32```
33
34### Quiz App Setup (Vue 3 + Vite)
35
36```bash
37cd quiz-app
38npm install
39npm run dev # Start development server
40npm run build # Build for production
41npm run lint # Run ESLint
42```
43
44### Bank Project API (Node.js + Express)
45
46```bash
47cd 7-bank-project/api
48npm install
49npm start # Start API server
50npm run lint # Run ESLint
51npm run format # Format with Prettier
52```
53
54### Browser Extension Projects
55
56```bash
57cd 5-browser-extension/solution
58npm install
59# Follow browser-specific extension loading instructions
60```
61
62### Space Game Projects
63
64```bash
65cd 6-space-game/solution
66npm install
67# Open index.html in browser or use Live Server
68```
69
70### Chat Project (Python Backend)
71
72```bash
73cd 9-chat-project/solution/backend/python
74pip install openai
75# Set GITHUB_TOKEN environment variable
76python api.py
77```
78
79## Development Workflow
80
81### For Content Contributors
82
831. **Fork the repository** to your GitHub account
842. **Clone your fork** locally
853. **Create a new branch** for your changes
864. Make changes to lesson content or code examples
875. Test any code changes in relevant project directories
886. Submit pull requests following contribution guidelines
89
90### For Learners
91
921. Fork or clone the repository
932. Navigate to lesson directories sequentially
943. Read README files for each lesson
954. Complete pre-lesson quizzes at https://ff-quizzes.netlify.app/web/
965. Work through code examples in lesson folders
976. Complete assignments and challenges
987. Take post-lesson quizzes
99
100### Live Development
101
102- **Documentation**: Run `docsify serve` in root (port 3000)
103- **Quiz App**: Run `npm run dev` in quiz-app directory
104- **Projects**: Use VS Code Live Server extension for HTML projects
105- **API Projects**: Run `npm start` in respective API directories
106
107## Testing Instructions
108
109### Quiz App Testing
110
111```bash
112cd quiz-app
113npm run lint # Check for code style issues
114npm run build # Verify build succeeds
115```
116
117### Bank API Testing
118
119```bash
120cd 7-bank-project/api
121npm run lint # Check for code style issues
122node server.js # Verify server starts without errors
123```
124
125### General Testing Approach
126
127- This is an educational repository without comprehensive automated tests
128- Manual testing focuses on:
129 - Code examples run without errors
130 - Links in documentation work correctly
131 - Project builds complete successfully
132 - Examples follow best practices
133
134### Pre-submission Checks
135
136- Run `npm run lint` in directories with package.json
137- Verify markdown links are valid
138- Test code examples in browser or Node.js
139- Check that translations maintain proper structure
140
141## Code Style Guidelines
142
143### JavaScript
144
145- Use modern ES6+ syntax
146- Follow standard ESLint configurations provided in projects
147- Use meaningful variable and function names for educational clarity
148- Add comments explaining concepts for learners
149- Format using Prettier where configured
150
151### HTML/CSS
152
153- Semantic HTML5 elements
154- Responsive design principles
155- Clear class naming conventions
156- Comments explaining CSS techniques for learners
157
158### Python
159
160- PEP 8 style guidelines
161- Clear, educational code examples
162- Type hints where helpful for learning
163
164### Markdown Documentation
165
166- Clear heading hierarchy
167- Code blocks with language specification
168- Links to additional resources
169- Screenshots and images in `images/` directories
170- Alt text for images for accessibility
171
172### File Organization
173
174- Lessons numbered sequentially (1-getting-started-lessons, 2-js-basics, etc.)
175- Each project has `solution/` and often `start/` or `your-work/` directories
176- Images stored in lesson-specific `images/` folders
177- Translations in `translations/{language-code}/` structure
178
179## Build and Deployment
180
181### Quiz App Deployment (Azure Static Web Apps)
182
183The quiz-app is configured for Azure Static Web Apps deployment:
184
185```bash
186cd quiz-app
187npm run build # Creates dist/ folder
188# Deploys via GitHub Actions workflow on push to main
189```
190
191Azure Static Web Apps configuration:
192- **App location**: `/quiz-app`
193- **Output location**: `dist`
194- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
195
196### Documentation PDF Generation
197
198```bash
199npm install # Install docsify-to-pdf
200npm run convert # Generate PDF from docs
201```
202
203### Docsify Documentation
204
205```bash
206npm install -g docsify-cli # Install Docsify globally
207docsify serve # Serve on localhost:3000
208```
209
210### Project-specific Builds
211
212Each project directory may have its own build process:
213- Vue projects: `npm run build` creates production bundles
214- Static projects: No build step, serve files directly
215
216## Pull Request Guidelines
217
218### Title Format
219
220Use clear, descriptive titles indicating the area of change:
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### Required Checks
227
228Before submitting a PR:
229
2301. **Code Quality**:
231 - Run `npm run lint` in affected project directories
232 - Fix all linting errors and warnings
233
2342. **Build Verification**:
235 - Run `npm run build` if applicable
236 - Ensure no build errors
237
2383. **Link Validation**:
239 - Test all markdown links
240 - Verify image references work
241
2424. **Content Review**:
243 - Proofread for spelling and grammar
244 - Ensure code examples are correct and educational
245 - Verify translations maintain original meaning
246
247### Contribution Requirements
248
249- Agree to Microsoft CLA (automated check on first PR)
250- Follow the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
251- See [CONTRIBUTING.md](./CONTRIBUTING.md) for detailed guidelines
252- Reference issue numbers in PR description if applicable
253
254### Review Process
255
256- PRs reviewed by maintainers and community
257- Educational clarity is prioritized
258- Code examples should follow current best practices
259- Translations reviewed for accuracy and cultural appropriateness
260
261## Translation System
262
263### Automated Translation
264
265- Uses GitHub Actions with co-op-translator workflow
266- Translates to 50+ languages automatically
267- Source files in main directories
268- Translated files in `translations/{language-code}/` directories
269
270### Adding Manual Translation Improvements
271
2721. Locate file in `translations/{language-code}/`
2732. Make improvements while preserving structure
2743. Ensure code examples remain functional
2754. Test any localized quiz content
276
277### Translation Metadata
278
279Translated files include metadata header:
280```markdown
281<!--
282CO_OP_TRANSLATOR_METADATA:
@@ −289 @@
289-->
290```
291
292## Debugging and Troubleshooting
293
294### Common Issues
295
296**Quiz app fails to start**:
297- Check Node.js version (v14+ recommended)
298- Delete `node_modules` and `package-lock.json`, run `npm install` again
299- Check for port conflicts (default: Vite uses port 5173)
300
301**API server won't start**:
302- Verify Node.js version meets minimum (node >=10)
303- Check if port is already in use
304- Ensure all dependencies installed with `npm install`
305
306**Browser extension won't load**:
307- Verify manifest.json is properly formatted
308- Check browser console for errors
309- Follow browser-specific extension installation instructions
310
311**Python chat project issues**:
312- Ensure OpenAI package installed: `pip install openai`
313- Verify GITHUB_TOKEN environment variable is set
314- Check GitHub Models access permissions
315
316**Docsify not serving docs**:
317- Install docsify-cli globally: `npm install -g docsify-cli`
318- Run from repository root directory
319- Check that `docs/_sidebar.md` exists
320
321### Development Environment Tips
322
323- Use VS Code with Live Server extension for HTML projects
324- Install ESLint and Prettier extensions for consistent formatting
325- Use browser DevTools for debugging JavaScript
326- For Vue projects, install Vue DevTools browser extension
327
328### Performance Considerations
329
330- Large number of translated files (50+ languages) means full clones are large
331- Use shallow clone if only working on content: `git clone --depth 1`
332- Exclude translations from searches when working on English content
333- Build processes may be slow on first run (npm install, Vite build)
334
335## Security Considerations
336
337### Environment Variables
338
339- API keys should never be committed to repository
340- Use `.env` files (already in `.gitignore`)
341- Document required environment variables in project READMEs
342
343### Python Projects
344
345- Use virtual environments: `python -m venv venv`
346- Keep dependencies updated
347- GitHub tokens should have minimal required permissions
348
349### GitHub Models Access
350
351- Personal Access Tokens (PAT) required for GitHub Models
352- Tokens should be stored as environment variables
353- Never commit tokens or credentials
354
355## Additional Notes
356
357### Target Audience
358
359- Complete beginners to web development
360- Students and self-learners
361- Teachers using the curriculum in classrooms
362- Content is designed for accessibility and gradual skill building
363
364### Educational Philosophy
365
366- Project-based learning approach
367- Frequent knowledge checks (quizzes)
368- Hands-on coding exercises
369- Real-world application examples
370- Focus on fundamentals before frameworks
371
372### Repository Maintenance
373
374- Active community of learners and contributors
375- Regular updates to dependencies and content
376- Issues and discussions monitored by maintainers
377- Translation updates automated via GitHub Actions
378
379### Related Resources
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) recommended for learners
384- Additional courses: Generative AI, Data Science, ML, IoT curricula available
385
386### Working with Specific Projects
387
388For detailed instructions on individual projects, refer to the README files in:
389- `quiz-app/README.md` - Vue 3 quiz application
390- `7-bank-project/README.md` - Banking application with authentication
391- `5-browser-extension/README.md` - Browser extension development
392- `6-space-game/README.md` - Canvas-based game development
393- `9-chat-project/README.md` - AI chat assistant project
394
395### Monorepo Structure
396
397While not a traditional monorepo, this repository contains multiple independent projects:
398- Each lesson is self-contained
399- Projects don't share dependencies
400- Work on individual projects without affecting others
401- Clone entire repo for the full curriculum experience
402
microsoft/Web-Dev-For-Beginners · translations/hi/AGENTS.md
@@ +1 @@
1# AGENTS.md
2
3## परियोजना अवलोकन
4
5यह शुरुआती लोगों को वेब विकास के मूल तत्व सिखाने के लिए एक शैक्षिक पाठ्यक्रम रिपॉजिटरी है। यह पाठ्यक्रम एक संपूर्ण 12-सप्ताह का कोर्स है जिसे Microsoft क्लाउड एडवोकेट्स द्वारा विकसित किया गया है, जिसमें JavaScript, CSS, और HTML को कवर करने वाले 24 व्यावहारिक पाठ होते हैं।
6
7### प्रमुख घटक
8
9- **शैक्षिक सामग्री**: परियोजना-आधारित मॉड्यूल में व्यवस्थित 24 संरचित पाठ
10- **व्यावहारिक परियोजनाएँ**: टेररियम, टाइपिंग गेम, ब्राउज़र एक्सटेंशन, स्पेस गेम, बैंकिंग ऐप, कोड संपादक, और एआई चैट असिस्टेंट
11- **इंटरएक्टिव क्विज़**: 48 क्विज़, प्रत्येक में 3 प्रश्न (पाठ से पहले और बाद में मूल्यांकन)
12- **बहु-भाषा समर्थन**: GitHub Actions के माध्यम से 50+ भाषाओं के लिए स्वचालित अनुवाद
13- **प्रौद्योगिकियाँ**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (एआई परियोजनाओं के लिए)
14
15### वास्तुकला
16
17- शैक्षिक रिपॉजिटरी जो पाठ-आधारित संरचना पर आधारित है
18- प्रत्येक पाठ फोल्डर में README, कोड उदाहरण, और समाधान हैं
19- स्वायत्त परियोजनाएँ अलग-अलग निर्देशिकाओं में (quiz-app, विभिन्न पाठ परियोजनाएँ)
20- GitHub Actions (co-op-translator) का उपयोग करते हुए अनुवाद प्रणाली
21- डॉक्सिफाई के माध्यम से प्रलेखन और 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 # 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 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` चलाएं
104- **परियोजनाएँ**: HTML परियोजनाओं के लिए VS कोड लाइव सर्वर एक्सटेंशन का उपयोग करें
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### जावास्क्रिप्ट
144
145- आधुनिक ES6+ सिंटैक्स का उपयोग करें
146- परियोजनाओं में दिए गए मानक ESLint कॉन्फ़िगरेशन का पालन करें
147- शिक्षार्थियों के लिए समझने योग्य वैरिएबल और फंक्शन नामों का उपयोग करें
148- अवधारणाओं की व्याख्या करने वाले टिप्पणियाँ जोड़ें
149- जहाँ कॉन्फ़िगर हो, Prettier का उपयोग कर स्वरूपित करें
150
151### HTML/CSS
152
153- सेमांटिक HTML5 तत्व
154- रिस्पॉन्सिव डिज़ाइन सिद्धांत
155- स्पष्ट क्लास नामकरण कन्वेंशंस
156- CSS तकनीकों की व्याख्या करने वाली टिप्पणियाँ
157
158### पायथन
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# मुख्य पर पुश करने पर 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### डॉक्सिफाई प्रलेखन
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] पाठ 5 के लिए स्पेनिश अनुवाद जोड़ें`
224- `[Docs] सेटअप निर्देश अपडेट करें`
225
226### आवश्यक जांच
227
228PR सबमिट करने से पहले:
229
2301. **कोड गुणवत्ता**:
231 - प्रभावित परियोजना निर्देशिकाओं में `npm run lint` चलाएं
232 - सभी linting त्रुटियों और चेतावनियों को ठीक करें
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- 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अनुवादित फ़ाइलों में मेटाडेटा हेडर शामिल होता है:
280```markdown
281<!--
282CO_OP_TRANSLATOR_METADATA:
@@ +289 @@
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**पायथन चैट प्रोजेक्ट समस्याएँ**:
312- OpenAI पैकेज स्थापित है: `pip install openai`
313- सुनिश्चित करें कि GITHUB_TOKEN पर्यावरण चर सेट है
314- GitHub मॉडल पहुँच अनुमतियाँ जांचें
315
316**डॉक्सिफाई दस्तावेज़ सेवा नहीं करता**:
317- docsify-cli ग्लोबली स्थापित करें: `npm install -g docsify-cli`
318- रिपॉजिटरी रूट निर्देशिका से चलाएं
319- जांचें कि `docs/_sidebar.md` मौजूद है
320
321### विकास पर्यावरण सुझाव
322
323- HTML परियोजनाओं के लिए VS Code में लाइव सर्वर एक्सटेंशन का उपयोग करें
324- सुसंगत फॉर्मेटिंग के लिए ESLint और Prettier एक्सटेंशन इंस्टॉल करें
325- JavaScript डिबगिंग के लिए ब्राउज़र DevTools का उपयोग करें
326- Vue परियोजनाओं के लिए Vue DevTools ब्राउज़र एक्सटेंशन इंस्टॉल करें
327
328### प्रदर्शन विचार
329
330- अनुवादित फ़ाइलों की बड़ी संख्या (50+ भाषाएँ) के कारण पूर्ण क्लोन बड़े होते हैं
331- केवल सामग्री पर काम करने के लिए शैलो क्लोन का उपयोग करें: `git clone --depth 1`
332- अंग्रेज़ी सामग्री पर काम करते समय अनुवाद खोजों से बाहर करें
333- बिल्ड प्रक्रियाएँ पहली बार धीमी हो सकती हैं (npm install, Vite build)
334
335## सुरक्षा विचार
336
337### पर्यावरण चर
338
339- API कुंजी को कभी रिपॉजिटरी में कमिट न करें
340- `.env` फ़ाइलें उपयोग करें (पहले से `.gitignore` में हैं)
341- आवश्यक पर्यावरण चर परियोजना READMEs में दस्तावेजीकृत करें
342
343### पायथन परियोजनाएँ
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- अतिरिक्त पाठ्यक्रम: जनरेटिव एआई, डेटा साइंस, एमएल, आईओटी पाठ्यक्रम उपलब्ध
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` - एआई चैट असिस्टेंट प्रोजेक्ट
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 -->
@@ −1 +1 @@
11 # AGENTS.md
22
3−## Project Overview
3+## परियोजना अवलोकन
44
5−This is an educational curriculum repository for teaching web development fundamentals to beginners. The curriculum is a comprehensive 12-week course developed by Microsoft Cloud Advocates, featuring 24 hands-on lessons covering JavaScript, CSS, and HTML.
5+यह शुरुआती लोगों को वेब विकास के मूल तत्व सिखाने के लिए एक शैक्षिक पाठ्यक्रम रिपॉजिटरी है। यह पाठ्यक्रम एक संपूर्ण 12-सप्ताह का कोर्स है जिसे Microsoft क्लाउड एडवोकेट्स द्वारा विकसित किया गया है, जिसमें JavaScript, CSS, और HTML को कवर करने वाले 24 व्यावहारिक पाठ होते हैं।
66
7−### Key Components
7+### प्रमुख घटक
88
9−- **Educational Content**: 24 structured lessons organized into project-based modules
10−- **Practical Projects**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, and AI Chat Assistant
11−- **Interactive Quizzes**: 48 quizzes with 3 questions each (pre/post-lesson assessments)
12−- **Multi-language Support**: Automated translations for 50+ languages via GitHub Actions
13−- **Technologies**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (for AI projects)
9+- **शैक्षिक सामग्री**: परियोजना-आधारित मॉड्यूल में व्यवस्थित 24 संरचित पाठ
10+- **व्यावहारिक परियोजनाएँ**: टेररियम, टाइपिंग गेम, ब्राउज़र एक्सटेंशन, स्पेस गेम, बैंकिंग ऐप, कोड संपादक, और एआई चैट असिस्टेंट
11+- **इंटरएक्टिव क्विज़**: 48 क्विज़, प्रत्येक में 3 प्रश्न (पाठ से पहले और बाद में मूल्यांकन)
12+- **बहु-भाषा समर्थन**: GitHub Actions के माध्यम से 50+ भाषाओं के लिए स्वचालित अनुवाद
13+- **प्रौद्योगिकियाँ**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (एआई परियोजनाओं के लिए)
1414
15−### Architecture
15+### वास्तुकला
1616
17−- Educational repository with lesson-based structure
18−- Each lesson folder contains README, code examples, and solutions
19−- Standalone projects in separate directories (quiz-app, various lesson projects)
20−- Translation system using GitHub Actions (co-op-translator)
21−- Documentation served via Docsify and available as PDF
17+- शैक्षिक रिपॉजिटरी जो पाठ-आधारित संरचना पर आधारित है
18+- प्रत्येक पाठ फोल्डर में README, कोड उदाहरण, और समाधान हैं
19+- स्वायत्त परियोजनाएँ अलग-अलग निर्देशिकाओं में (quiz-app, विभिन्न पाठ परियोजनाएँ)
20+- GitHub Actions (co-op-translator) का उपयोग करते हुए अनुवाद प्रणाली
21+- डॉक्सिफाई के माध्यम से प्रलेखन और PDF के रूप में उपलब्ध
2222
23−## Setup Commands
23+## सेटअप कमांड
2424
25−This repository is primarily for educational content consumption. For working with specific projects:
25+यह रिपॉजिटरी मुख्य रूप से शैक्षिक सामग्री उपभोग के लिए है। विशिष्ट परियोजनाओं के साथ काम करने के लिए:
2626
27−### Main Repository Setup
27+### मुख्य रिपॉजिटरी सेटअप
2828
2929 ```bash
3030 git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
3131 cd Web-Dev-For-Beginners
3232 ```
3333
34−### Quiz App Setup (Vue 3 + Vite)
34+### क्विज़ ऐप सेटअप (Vue 3 + Vite)
3535
3636 ```bash
3737 cd quiz-app
3838 npm install
39−npm run dev # Start development server
40−npm run build # Build for production
41−npm run lint # Run ESLint
39+npm run dev # विकास सर्वर शुरू करें
40+npm run build # प्रोडक्शन के लिए निर्माण करें
41+npm run lint # ESLint चलाएं
4242 ```
4343
44−### Bank Project API (Node.js + Express)
44+### बैंक प्रोजेक्ट API (Node.js + Express)
4545
4646 ```bash
4747 cd 7-bank-project/api
4848 npm install
49−npm start # Start API server
50−npm run lint # Run ESLint
51−npm run format # Format with Prettier
49+npm start # एपीआई सर्वर शुरू करें
50+npm run lint # ESLint चलाएं
51+npm run format # Prettier के साथ फॉर्मेट करें
5252 ```
5353
54−### Browser Extension Projects
54+### ब्राउज़र एक्सटेंशन परियोजनाएँ
5555
5656 ```bash
5757 cd 5-browser-extension/solution
5858 npm install
59−# Follow browser-specific extension loading instructions
59+# ब्राउज़र-विशिष्ट एक्सटेंशन लोडिंग निर्देशों का पालन करें
6060 ```
6161
62−### Space Game Projects
62+### स्पेस गेम परियोजनाएँ
6363
6464 ```bash
6565 cd 6-space-game/solution
6666 npm install
67−# Open index.html in browser or use Live Server
67+# index.html को ब्राउज़र में खोलें या लाइव सर्वर का उपयोग करें
6868 ```
6969
70−### Chat Project (Python Backend)
70+### चैट प्रोजेक्ट (Python Backend)
7171
7272 ```bash
7373 cd 9-chat-project/solution/backend/python
7474 pip install openai
75−# Set GITHUB_TOKEN environment variable
75+# GITHUB_TOKEN पर्यावरण चर सेट करें
7676 python api.py
7777 ```
7878
79−## Development Workflow
79+## विकास कार्यप्रवाह
8080
81−### For Content Contributors
81+### सामग्री योगदानकर्ताओं के लिए
8282
83−1. **Fork the repository** to your GitHub account
84−2. **Clone your fork** locally
85−3. **Create a new branch** for your changes
86−4. Make changes to lesson content or code examples
87−5. Test any code changes in relevant project directories
88−6. Submit pull requests following contribution guidelines
83+1. अपने GitHub खाते में रिपॉजिटरी को **फोर्क** करें
84+2. अपने फोर्क को स्थानीय रूप से **क्लोन** करें
85+3. अपने परिवर्तनों के लिए एक नई शाखा बनाएं
86+4. पाठ सामग्री या कोड उदाहरणों में परिवर्तन करें
87+5. संबंधित परियोजना निर्देशिकाओं में कोड परिवर्तन का परीक्षण करें
88+6. योगदान दिशानिर्देशों का पालन करते हुए पुल अनुरोध जमा करें
8989
90−### For Learners
90+### शिक्षार्थियों के लिए
9191
92−1. Fork or clone the repository
93−2. Navigate to lesson directories sequentially
94−3. Read README files for each lesson
95−4. Complete pre-lesson quizzes at https://ff-quizzes.netlify.app/web/
96−5. Work through code examples in lesson folders
97−6. Complete assignments and challenges
98−7. Take post-lesson quizzes
92+1. रिपॉजिटरी को फोर्क या क्लोन करें
93+2. पाठ निर्देशिकाओं में क्रमबद्ध रूप से नेविगेट करें
94+3. प्रत्येक पाठ के README फ़ाइलें पढ़ें
95+4. प्री-लर्निंग क्विज़ को https://ff-quizzes.netlify.app/web/ पर पूरा करें
96+5. पाठ फ़ोल्डरों में कोड उदाहरणों पर काम करें
97+6. असाइनमेंट और चुनौतियाँ पूरी करें
98+7. पोस्ट-लर्निंग क्विज़ लें
9999
100−### Live Development
100+### लाइव विकास
101101
102−- **Documentation**: Run `docsify serve` in root (port 3000)
103−- **Quiz App**: Run `npm run dev` in quiz-app directory
104−- **Projects**: Use VS Code Live Server extension for HTML projects
105−- **API Projects**: Run `npm start` in respective API directories
102+- **प्रलेखन**: रूट में `docsify serve` चलाएं (पोर्ट 3000)
103+- **क्विज़ ऐप**: क्विज़-ऐप निर्देशिका में `npm run dev` चलाएं
104+- **परियोजनाएँ**: HTML परियोजनाओं के लिए VS कोड लाइव सर्वर एक्सटेंशन का उपयोग करें
105+- **API परियोजनाएँ**: संबंधित API निर्देशिकाओं में `npm start` चलाएं
106106
107−## Testing Instructions
107+## परीक्षण निर्देश
108108
109−### Quiz App Testing
109+### क्विज़ ऐप परीक्षण
110110
111111 ```bash
112112 cd quiz-app
113−npm run lint # Check for code style issues
114−npm run build # Verify build succeeds
113+npm run lint # कोड शैली की समस्याओं की जांच करें
114+npm run build # सुनिश्चित करें कि निर्माण सफल हो जाता है
115115 ```
116116
117−### Bank API Testing
117+### बैंक API परीक्षण
118118
119119 ```bash
120120 cd 7-bank-project/api
121−npm run lint # Check for code style issues
122−node server.js # Verify server starts without errors
121+npm run lint # कोड शैली मुद्दों की जांच करें
122+node server.js # यह सत्यापित करें कि सर्वर बिना त्रुटियों के शुरू होता है
123123 ```
124124
125−### General Testing Approach
125+### सामान्य परीक्षण दृष्टिकोण
126126
127−- This is an educational repository without comprehensive automated tests
128−- Manual testing focuses on:
129− - Code examples run without errors
130− - Links in documentation work correctly
131− - Project builds complete successfully
132− - Examples follow best practices
127+- यह एक शैक्षिक रिपॉजिटरी है जिसमें व्यापक स्वचालित परीक्षण नहीं हैं
128+- मैनुअल परीक्षण पर केंद्रित:
129+ - कोड उदाहरण बिना त्रुटि के चलते हैं
130+ - दस्तावेज़ीकरण के लिंक सही कार्य करते हैं
131+ - परियोजना बिल्ड सफलतापूर्वक पूरी होती है
132+ - उदाहरण सर्वोत्तम प्रथाओं का पालन करते हैं
133133
134−### Pre-submission Checks
134+### सबमिशन से पहले जांच
135135
136−- Run `npm run lint` in directories with package.json
137−- Verify markdown links are valid
138−- Test code examples in browser or Node.js
139−- Check that translations maintain proper structure
136+- `package.json` वाले निर्देशिकाओं में `npm run lint` चलाएं
137+- मार्कडाउन लिंक मान्य हैं यह पुष्टि करें
138+- ब्राउज़र या Node.js में कोड उदाहरणों का परीक्षण करें
139+- जांचें कि अनुवाद उचित संरचना बनाए रखते हैं
140140
141−## Code Style Guidelines
141+## कोड स्टाइल दिशानिर्देश
142142
143−### JavaScript
143+### जावास्क्रिप्ट
144144
145−- Use modern ES6+ syntax
146−- Follow standard ESLint configurations provided in projects
147−- Use meaningful variable and function names for educational clarity
148−- Add comments explaining concepts for learners
149−- Format using Prettier where configured
145+- आधुनिक ES6+ सिंटैक्स का उपयोग करें
146+- परियोजनाओं में दिए गए मानक ESLint कॉन्फ़िगरेशन का पालन करें
147+- शिक्षार्थियों के लिए समझने योग्य वैरिएबल और फंक्शन नामों का उपयोग करें
148+- अवधारणाओं की व्याख्या करने वाले टिप्पणियाँ जोड़ें
149+- जहाँ कॉन्फ़िगर हो, Prettier का उपयोग कर स्वरूपित करें
150150
151151 ### HTML/CSS
152152
153−- Semantic HTML5 elements
154−- Responsive design principles
155−- Clear class naming conventions
156−- Comments explaining CSS techniques for learners
153+- सेमांटिक HTML5 तत्व
154+- रिस्पॉन्सिव डिज़ाइन सिद्धांत
155+- स्पष्ट क्लास नामकरण कन्वेंशंस
156+- CSS तकनीकों की व्याख्या करने वाली टिप्पणियाँ
157157
158−### Python
158+### पायथन
159159
160−- PEP 8 style guidelines
161−- Clear, educational code examples
162−- Type hints where helpful for learning
160+- PEP 8 शैली दिशानिर्देश
161+- साफ, शैक्षिक कोड उदाहरण
162+- सीखने में मदद करने के लिए प्रकार संकेत
163163
164−### Markdown Documentation
164+### मार्कडाउन दस्तावेज़ीकरण
165165
166−- Clear heading hierarchy
167−- Code blocks with language specification
168−- Links to additional resources
169−- Screenshots and images in `images/` directories
170−- Alt text for images for accessibility
166+- स्पष्ट हेडिंग पदानुक्रम
167+- भाषा निर्दिष्ट कोड ब्लॉक
168+- अतिरिक्त संसाधनों के लिंक
169+- `images/` निर्देशिकाओं में स्क्रीनशॉट्स और चित्र
170+- पहुँच के लिए छवियों के लिए alt टेक्स्ट
171171
172−### File Organization
172+### फ़ाइल संगठन
173173
174−- Lessons numbered sequentially (1-getting-started-lessons, 2-js-basics, etc.)
175−- Each project has `solution/` and often `start/` or `your-work/` directories
176−- Images stored in lesson-specific `images/` folders
177−- Translations in `translations/{language-code}/` structure
174+- पाठ क्रम से क्रमांकित (1-getting-started-lessons, 2-js-basics, आदि)
175+- प्रत्येक परियोजना में `solution/` और अक्सर `start/` या `your-work/` निर्देशिकाएँ होती हैं
176+- पाठ-विशिष्ट `images/` फ़ोल्डरों में चित्र संग्रहीत
177+- अनुवाद `translations/{language-code}/` संरचना में
178178
179−## Build and Deployment
179+## निर्माण और तैनाती
180180
181−### Quiz App Deployment (Azure Static Web Apps)
181+### क्विज़ ऐप तैनाती (Azure Static Web Apps)
182182
183−The quiz-app is configured for Azure Static Web Apps deployment:
183+क्विज़-ऐप Azure Static Web Apps तैनाती के लिए कॉन्फ़िगर किया गया है:
184184
185185 ```bash
186186 cd quiz-app
187−npm run build # Creates dist/ folder
188−# Deploys via GitHub Actions workflow on push to main
187+npm run build # dist/ फ़ोल्डर बनाता है
188+# मुख्य पर पुश करने पर GitHub Actions वर्कफ़्लो के माध्यम से डिप्लॉय करता है
189189 ```
190190
191−Azure Static Web Apps configuration:
192−- **App location**: `/quiz-app`
193−- **Output location**: `dist`
194−- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
191+Azure Static Web Apps कॉन्फ़िगरेशन:
192+- **ऐप स्थान**: `/quiz-app`
193+- **आउटपुट स्थान**: `dist`
194+- **वर्कफ़्लो**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
195195
196−### Documentation PDF Generation
196+### प्रलेखन PDF निर्माण
197197
198198 ```bash
199−npm install # Install docsify-to-pdf
200−npm run convert # Generate PDF from docs
199+npm install # docsify-to-pdf स्थापित करें
200+npm run convert # docs से PDF उत्पन्न करें
201201 ```
202202
203−### Docsify Documentation
203+### डॉक्सिफाई प्रलेखन
204204
205205 ```bash
206−npm install -g docsify-cli # Install Docsify globally
207−docsify serve # Serve on localhost:3000
206+npm install -g docsify-cli # Docsify को वैश्विक रूप से स्थापित करें
207+docsify serve # localhost:3000 पर सेवा दें
208208 ```
209209
210−### Project-specific Builds
210+### परियोजना-विशिष्ट निर्माण
211211
212−Each project directory may have its own build process:
213−- Vue projects: `npm run build` creates production bundles
214−- Static projects: No build step, serve files directly
212+प्रत्येक परियोजना निर्देशिका में अपना निर्माण प्रक्रिया हो सकती है:
213+- Vue परियोजनाएँ: `npm run build` प्रोडक्शन बंडल बनाता है
214+- स्थैतिक परियोजनाएँ: कोई निर्माण चरण नहीं, सीधे फ़ाइलें सेवा दें
215215
216−## Pull Request Guidelines
216+## पुल अनुरोध दिशानिर्देश
217217
218−### Title Format
218+### शीर्षक प्रारूप
219219
220−Use clear, descriptive titles indicating the area of change:
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`
220+स्पष्ट, वर्णनात्मक शीर्षक का उपयोग करें जो परिवर्तन क्षेत्र को दर्शाता हो:
221+- `[Quiz-app] पाठ X के लिए नया क्विज़ जोड़ें`
222+- `[Lesson-3] टेररियम परियोजना में वर्तनी सुधारें`
223+- `[Translation] पाठ 5 के लिए स्पेनिश अनुवाद जोड़ें`
224+- `[Docs] सेटअप निर्देश अपडेट करें`
225225
226−### Required Checks
226+### आवश्यक जांच
227227
228−Before submitting a PR:
228+PR सबमिट करने से पहले:
229229
230−1. **Code Quality**:
231− - Run `npm run lint` in affected project directories
232− - Fix all linting errors and warnings
230+1. **कोड गुणवत्ता**:
231+ - प्रभावित परियोजना निर्देशिकाओं में `npm run lint` चलाएं
232+ - सभी linting त्रुटियों और चेतावनियों को ठीक करें
233233
234−2. **Build Verification**:
235− - Run `npm run build` if applicable
236− - Ensure no build errors
234+2. **निर्माण सत्यापन**:
235+ - जहां लागू हो, `npm run build` चलाएं
236+ - सुनिश्चित करें कि कोई निर्माण त्रुटि न हो
237237
238−3. **Link Validation**:
239− - Test all markdown links
240− - Verify image references work
238+3. **लिंक सत्यापन**:
239+ - सभी मार्कडाउन लिंक का परीक्षण करें
240+ - छवि संदर्भ काम करें यह जांचें
241241
242−4. **Content Review**:
243− - Proofread for spelling and grammar
244− - Ensure code examples are correct and educational
245− - Verify translations maintain original meaning
242+4. **सामग्री समीक्षा**:
243+ - वर्तनी और व्याकरण की जांच करें
244+ - सुनिश्चित करें कि कोड उदाहरण सही और शैक्षिक हैं
245+ - अनुवाद मूल अर्थ को बनाए रखें
246246
247−### Contribution Requirements
247+### योगदान आवश्यकताएँ
248248
249−- Agree to Microsoft CLA (automated check on first PR)
250−- Follow the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
251−- See [CONTRIBUTING.md](./CONTRIBUTING.md) for detailed guidelines
252−- Reference issue numbers in PR description if applicable
249+- Microsoft CLA (पहले PR पर स्वचालित जांच) से सहमत हों
250+- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) का पालन करें
251+- विस्तृत दिशानिर्देशों के लिए [CONTRIBUTING.md](./CONTRIBUTING.md) देखें
252+- यदि लागू हो, तो PR विवरण में मुद्दा संख्या का संदर्भ दें
253253
254−### Review Process
254+### समीक्षा प्रक्रिया
255255
256−- PRs reviewed by maintainers and community
257−- Educational clarity is prioritized
258−- Code examples should follow current best practices
259−- Translations reviewed for accuracy and cultural appropriateness
256+- PRs मेंटेनर्स और समुदाय द्वारा समीक्षा किए जाते हैं
257+- शैक्षिक स्पष्टता को प्राथमिकता दी जाती है
258+- कोड उदाहरणों को वर्तमान सर्वोत्तम प्रथाओं का पालन करना चाहिए
259+- अनुवादों को सटीकता और सांस्कृतिक उपयुक्तता के लिए समीक्षा किया जाता है
260260
261−## Translation System
261+## अनुवाद प्रणाली
262262
263−### Automated Translation
263+### स्वचालित अनुवाद
264264
265−- Uses GitHub Actions with co-op-translator workflow
266−- Translates to 50+ languages automatically
267−- Source files in main directories
268−- Translated files in `translations/{language-code}/` directories
265+- GitHub Actions के साथ co-op-translator वर्कफ़्लो का उपयोग करता है
266+- 50+ भाषाओं में स्वचालित रूप से अनुवाद करता है
267+- स्रोत फाइलें मुख्य निर्देशिकाओं में होती हैं
268+- अनुवादित फाइलें `translations/{language-code}/` निर्देशिकाओं में होती हैं
269269
270−### Adding Manual Translation Improvements
270+### मैनुअल अनुवाद सुधार जोड़ना
271271
272−1. Locate file in `translations/{language-code}/`
273−2. Make improvements while preserving structure
274−3. Ensure code examples remain functional
275−4. Test any localized quiz content
272+1. `translations/{language-code}/` में फ़ाइल का पता लगाएं
273+2. संरचना बनाए रखते हुए सुधार करें
274+3. सुनिश्चित करें कि कोड उदाहरण कार्यशील बने रहें
275+4. स्थानीयकृत क्विज़ सामग्री का परीक्षण करें
276276
277−### Translation Metadata
277+### अनुवाद मेटाडेटा
278278
279−Translated files include metadata header:
279+अनुवादित फ़ाइलों में मेटाडेटा हेडर शामिल होता है:
280280 ```markdown
281281 <!--
282282 CO_OP_TRANSLATOR_METADATA:
@@ −289 +289 @@
289289 -->
290290 ```
291291
292−## Debugging and Troubleshooting
292+## डिबगिंग और समस्या निवारण
293293
294−### Common Issues
294+### सामान्य समस्याएँ
295295
296−**Quiz app fails to start**:
297−- Check Node.js version (v14+ recommended)
298−- Delete `node_modules` and `package-lock.json`, run `npm install` again
299−- Check for port conflicts (default: Vite uses port 5173)
296+**क्विज़ ऐप शुरू नहीं होता**:
297+- Node.js संस्करण जांचें (v14+ अनुशंसित)
298+- `node_modules` और `package-lock.json` हटाएं, फिर `npm install` चलाएं
299+- पोर्ट संघर्ष जांचें (डिफ़ॉल्ट: Vite पोर्ट 5173 उपयोग करता है)
300300
301−**API server won't start**:
302−- Verify Node.js version meets minimum (node >=10)
303−- Check if port is already in use
304−- Ensure all dependencies installed with `npm install`
301+**API सर्वर शुरू नहीं होता**:
302+- Node.js संस्करण न्यूनतम (node >=10) होना चाहिए
303+- जांचें कि पोर्ट पहले से उपयोग में तो नहीं है
304+- सुनिश्चित करें कि सभी निर्भरताएं `npm install` से स्थापित हैं
305305
306−**Browser extension won't load**:
307−- Verify manifest.json is properly formatted
308−- Check browser console for errors
309−- Follow browser-specific extension installation instructions
306+**ब्राउज़र एक्सटेंशन लोड नहीं होता**:
307+- manifest.json सही फ़ॉर्मेट में है यह जांचें
308+- ब्राउज़र कंसोल में त्रुटियाँ देखें
309+- ब्राउज़र-विशिष्ट एक्सटेंशन इंस्टॉलेशन निर्देशों का पालन करें
310310
311−**Python chat project issues**:
312−- Ensure OpenAI package installed: `pip install openai`
313−- Verify GITHUB_TOKEN environment variable is set
314−- Check GitHub Models access permissions
311+**पायथन चैट प्रोजेक्ट समस्याएँ**:
312+- OpenAI पैकेज स्थापित है: `pip install openai`
313+- सुनिश्चित करें कि GITHUB_TOKEN पर्यावरण चर सेट है
314+- GitHub मॉडल पहुँच अनुमतियाँ जांचें
315315
316−**Docsify not serving docs**:
317−- Install docsify-cli globally: `npm install -g docsify-cli`
318−- Run from repository root directory
319−- Check that `docs/_sidebar.md` exists
316+**डॉक्सिफाई दस्तावेज़ सेवा नहीं करता**:
317+- docsify-cli ग्लोबली स्थापित करें: `npm install -g docsify-cli`
318+- रिपॉजिटरी रूट निर्देशिका से चलाएं
319+- जांचें कि `docs/_sidebar.md` मौजूद है
320320
321−### Development Environment Tips
321+### विकास पर्यावरण सुझाव
322322
323−- Use VS Code with Live Server extension for HTML projects
324−- Install ESLint and Prettier extensions for consistent formatting
325−- Use browser DevTools for debugging JavaScript
326−- For Vue projects, install Vue DevTools browser extension
323+- HTML परियोजनाओं के लिए VS Code में लाइव सर्वर एक्सटेंशन का उपयोग करें
324+- सुसंगत फॉर्मेटिंग के लिए ESLint और Prettier एक्सटेंशन इंस्टॉल करें
325+- JavaScript डिबगिंग के लिए ब्राउज़र DevTools का उपयोग करें
326+- Vue परियोजनाओं के लिए Vue DevTools ब्राउज़र एक्सटेंशन इंस्टॉल करें
327327
328−### Performance Considerations
328+### प्रदर्शन विचार
329329
330−- Large number of translated files (50+ languages) means full clones are large
331−- Use shallow clone if only working on content: `git clone --depth 1`
332−- Exclude translations from searches when working on English content
333−- Build processes may be slow on first run (npm install, Vite build)
330+- अनुवादित फ़ाइलों की बड़ी संख्या (50+ भाषाएँ) के कारण पूर्ण क्लोन बड़े होते हैं
331+- केवल सामग्री पर काम करने के लिए शैलो क्लोन का उपयोग करें: `git clone --depth 1`
332+- अंग्रेज़ी सामग्री पर काम करते समय अनुवाद खोजों से बाहर करें
333+- बिल्ड प्रक्रियाएँ पहली बार धीमी हो सकती हैं (npm install, Vite build)
334334
335−## Security Considerations
335+## सुरक्षा विचार
336336
337−### Environment Variables
337+### पर्यावरण चर
338338
339−- API keys should never be committed to repository
340−- Use `.env` files (already in `.gitignore`)
341−- Document required environment variables in project READMEs
339+- API कुंजी को कभी रिपॉजिटरी में कमिट न करें
340+- `.env` फ़ाइलें उपयोग करें (पहले से `.gitignore` में हैं)
341+- आवश्यक पर्यावरण चर परियोजना READMEs में दस्तावेजीकृत करें
342342
343−### Python Projects
343+### पायथन परियोजनाएँ
344344
345−- Use virtual environments: `python -m venv venv`
346−- Keep dependencies updated
347−- GitHub tokens should have minimal required permissions
345+- वर्चुअल एनवायरनमेंट का उपयोग करें: `python -m venv venv`
346+- निर्भरताओं को अपडेट रखें
347+- GitHub टोकन के पास न्यूनतम आवश्यक अनुमतियाँ होनी चाहिए
348348
349−### GitHub Models Access
349+### GitHub मॉडल्स एक्सेस
350350
351−- Personal Access Tokens (PAT) required for GitHub Models
352−- Tokens should be stored as environment variables
353−- Never commit tokens or credentials
351+- GitHub मॉडल्स के लिए व्यक्तिगत एक्सेस टोकन (PAT) आवश्यक हैं
352+- टोकन को पर्यावरण चरों के रूप में सहेजें
353+- टोकन या क्रेडेंशियल्स को कभी कमिट न करें
354354
355−## Additional Notes
355+## अतिरिक्त नोट्स
356356
357−### Target Audience
357+### लक्षित दर्शक
358358
359−- Complete beginners to web development
360−- Students and self-learners
361−- Teachers using the curriculum in classrooms
362−- Content is designed for accessibility and gradual skill building
359+- वेब विकास के पूर्ण शुरुआती
360+- छात्र और स्वयं-अधिगमकर्ता
361+- कक्षाओं में पाठ्यक्रम का उपयोग करने वाले शिक्षक
362+- सामग्री सुलभता और धीरे-धीरे कौशल निर्माण के लिए डिज़ाइन की गई है
363363
364−### Educational Philosophy
364+### शैक्षिक दर्शन
365365
366−- Project-based learning approach
367−- Frequent knowledge checks (quizzes)
368−- Hands-on coding exercises
369−- Real-world application examples
370−- Focus on fundamentals before frameworks
366+- परियोजना-आधारित सीखने का दृष्टिकोण
367+- बार-बार ज्ञान जांच (क्विज़)
368+- व्यावहारिक कोडिंग अभ्यास
369+- वास्तविक विश्व अनुप्रयोग उदाहरण
370+- फ्रेमवर्क से पहले मूल बातें पर फोकस
371371
372−### Repository Maintenance
372+### रिपॉजिटरी रखरखाव
373373
374−- Active community of learners and contributors
375−- Regular updates to dependencies and content
376−- Issues and discussions monitored by maintainers
377−- Translation updates automated via GitHub Actions
374+- शिक्षार्थियों और योगदानकर्ताओं की सक्रिय समुदाय
375+- निर्भरताओं और सामग्री के नियमित अपडेट
376+- मेंटेनर्स द्वारा मुद्दों और चर्चाओं की निगरानी
377+- GitHub Actions के जरिए अनुवाद अपडेट स्वचालित
378378
379−### Related Resources
379+### संबंधित संसाधन
380380
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) recommended for learners
384−- Additional courses: Generative AI, Data Science, ML, IoT curricula available
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+- अतिरिक्त पाठ्यक्रम: जनरेटिव एआई, डेटा साइंस, एमएल, आईओटी पाठ्यक्रम उपलब्ध
385385
386−### Working with Specific Projects
386+### विशिष्ट परियोजनाओं के साथ कार्य करना
387387
388−For detailed instructions on individual projects, refer to the README files in:
389−- `quiz-app/README.md` - Vue 3 quiz application
390−- `7-bank-project/README.md` - Banking application with authentication
391−- `5-browser-extension/README.md` - Browser extension development
392−- `6-space-game/README.md` - Canvas-based game development
393−- `9-chat-project/README.md` - AI chat assistant project
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` - एआई चैट असिस्टेंट प्रोजेक्ट
394394
395−### Monorepo Structure
395+### मोनोरिपॉ संरचना
396396
397−While not a traditional monorepo, this repository contains multiple independent projects:
398−- Each lesson is self-contained
399−- Projects don't share dependencies
400−- Work on individual projects without affecting others
401−- Clone entire repo for the full curriculum experience
397+हालांकि यह पारंपरिक मोनोरिपॉ नहीं है, इस रिपॉजिटरी में कई स्वतंत्र परियोजनाएँ हैं:
398+- प्रत्येक पाठ स्वतंत्र है
399+- परियोजनाएँ निर्भरताओं को साझा नहीं करती हैं
400+- अन्य परियोजनाओं को प्रभावित किए बिना व्यक्तिगत परियोजनाओं पर काम करें
401+- पूर्ण पाठ्यक्रम अनुभव के लिए पूरी रिपॉजिटरी क्लोन करें
402402
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 -->
