Data-Science-For-Beginners/translations/ne/AGENTS.md

# AGENTS.md

## परियोजना अवलोकन

डाटा साइन्स फर बिगिनर्स माइक्रोसफ्ट एजर क्लाउड एड्भोकेट्सद्वारा सिर्जना गरिएको १० हप्ताको, २० पाठको व्यापक पाठ्यक्रम हो। यो रिपोजिटरी एक सिकाइ स्रोत हो जसले परियोजना-आधारित पाठहरू मार्फत आधारभूत डाटा साइन्स अवधारणाहरू सिकाउँछ, जसमा जुपिटर नोटबुकहरू, अन्तरक्रियात्मक क्विजहरू, र व्यावहारिक असाइनमेन्टहरू समावेश छन्।

**मुख्य प्रविधिहरू:**
- **जुपिटर नोटबुकहरू**: पाइथन ३ प्रयोग गरेर प्राथमिक सिकाइ माध्यम
- **पाइथन लाइब्रेरीहरू**: pandas, numpy, matplotlib डाटा विश्लेषण र भिजुअलाइजेसनका लागि
- **Vue.js 2**: क्विज एप्लिकेसन (quiz-app फोल्डर)
- **Docsify**: अफलाइन पहुँचको लागि डकुमेन्टेसन साइट जेनेरेटर
- **Node.js/npm**: जाभास्क्रिप्ट कम्पोनेन्टहरूको प्याकेज व्यवस्थापन
- **Markdown**: सबै पाठ सामग्री र डकुमेन्टेसन

**आर्किटेक्चर:**
- बहुभाषी शैक्षिक रिपोजिटरी विस्तृत अनुवादहरूसँग
- पाठ मोड्युलहरूमा संरचित (१-परिचयदेखि ६-डाटा-साइन्स-इन-वाइल्डसम्म)
- प्रत्येक पाठमा README, नोटबुकहरू, असाइनमेन्टहरू, र क्विजहरू समावेश छन्
- स्वतन्त्र Vue.js क्विज एप्लिकेसन प्रि/पोस्ट-पाठ मूल्याङ्कनका लागि
- GitHub Codespaces र VS Code dev containers समर्थन

## सेटअप कमाण्डहरू

### रिपोजिटरी सेटअप
```bash
# Clone the repository (if not already cloned)
git clone https://github.com/microsoft/Data-Science-For-Beginners.git
cd Data-Science-For-Beginners
```

### पाइथन वातावरण सेटअप
```bash
# Create a virtual environment (recommended)
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install common data science libraries (no requirements.txt exists)
pip install jupyter pandas numpy matplotlib seaborn scikit-learn
```

### क्विज एप्लिकेसन सेटअप
```bash
# Navigate to quiz app
cd quiz-app

# Install dependencies
npm install

# Start development server
npm run serve

# Build for production
npm run build

# Lint and fix files
npm run lint
```

### Docsify डकुमेन्टेसन सर्भर
```bash
# Install Docsify globally
npm install -g docsify-cli

# Serve documentation locally
docsify serve

# Documentation will be available at localhost:3000
```

### भिजुअलाइजेसन परियोजनाहरू सेटअप
जस्तै meaningful-visualizations (पाठ १३) को लागि:
```bash
# Navigate to starter or solution folder
cd 3-Data-Visualization/13-meaningful-visualizations/starter

# Install dependencies
npm install

# Start development server
npm run serve

# Build for production
npm run build

# Lint files
npm run lint
```

## विकास कार्यप्रवाह

### जुपिटर नोटबुकहरूसँग काम गर्दै
1. रिपोजिटरीको रूटमा जुपिटर सुरु गर्नुहोस्: `jupyter notebook`
2. इच्छित पाठ फोल्डरमा जानुहोस्
3. `.ipynb` फाइलहरू खोल्नुहोस् र अभ्यासहरू पूरा गर्नुहोस्
4. नोटबुकहरू व्याख्या र कोड सेलहरूसँग आत्म-समावेशित छन्
5. अधिकांश नोटबुकहरूले pandas, numpy, र matplotlib प्रयोग गर्छन् - सुनिश्चित गर्नुहोस् कि यी स्थापना भएका छन्

### पाठ संरचना
प्रत्येक पाठमा सामान्यतया समावेश हुन्छ:
- `README.md` - सिद्धान्त र उदाहरणहरूसहित मुख्य पाठ सामग्री
- `notebook.ipynb` - व्यावहारिक जुपिटर नोटबुक अभ्यासहरू
- `assignment.ipynb` वा `assignment.md` - अभ्यास असाइनमेन्टहरू
- `solution/` फोल्डर - समाधान नोटबुकहरू र कोड
- `images/` फोल्डर - सहायक भिजुअल सामग्रीहरू

### क्विज एप्लिकेसन विकास
- Vue.js 2 एप्लिकेसन विकासको क्रममा हट-रिलोडको साथ
- क्विजहरू `quiz-app/src/assets/translations/` मा भण्डारण गरिन्छ
- प्रत्येक भाषाको आफ्नै अनुवाद फोल्डर हुन्छ (en, fr, es, आदि)
- क्विज नम्बरिङ ० बाट सुरु हुन्छ र ३९ सम्म जान्छ (कुल ४० क्विजहरू)

### अनुवादहरू थप्दै
- अनुवादहरू रिपोजिटरी रूटको `translations/` फोल्डरमा जान्छन्
- प्रत्येक भाषाको संरचना अंग्रेजीबाट मिरर गरिएको छ
- GitHub Actions मार्फत स्वचालित अनुवाद (co-op-translator.yml)

## परीक्षण निर्देशनहरू

### क्विज एप्लिकेसन परीक्षण
```bash
cd quiz-app

# Run lint checks
npm run lint

# Test build process
npm run build

# Manual testing: Start dev server and verify quiz functionality
npm run serve
```

### नोटबुक परीक्षण
- नोटबुकहरूको लागि कुनै स्वचालित परीक्षण फ्रेमवर्क छैन
- म्यानुअल मान्यता: कुनै त्रुटि नभएको सुनिश्चित गर्न सबै सेलहरू क्रमशः चलाउनुहोस्
- डाटा फाइलहरू पहुँचयोग्य छन् र आउटपुटहरू सही रूपमा उत्पन्न भएको सुनिश्चित गर्नुहोस्
- भिजुअलाइजेसनहरू सही रूपमा प्रस्तुत भएको जाँच गर्नुहोस्

### डकुमेन्टेसन परीक्षण
```bash
# Verify Docsify renders correctly
docsify serve

# Check for broken links manually by navigating through content
# Verify all lesson links work in the rendered documentation
```

### कोड गुणस्तर जाँच
```bash
# Vue.js projects (quiz-app and visualization projects)
cd quiz-app  # or visualization project folder
npm run lint

# Python notebooks - manual verification recommended
# Ensure imports work and cells execute without errors
```

## कोड शैली दिशानिर्देशहरू

### पाइथन (जुपिटर नोटबुकहरू)
- पाइथन कोडको लागि PEP 8 शैली दिशानिर्देशहरू पालना गर्नुहोस्
- विश्लेषण गरिरहेको डाटालाई स्पष्ट रूपमा व्याख्या गर्ने भेरिएबल नामहरू प्रयोग गर्नुहोस्
- कोड सेलहरू अघि व्याख्या सहितको मार्कडाउन सेलहरू समावेश गर्नुहोस्
- कोड सेलहरू एकल अवधारणा वा अपरेशनहरूमा केन्द्रित राख्नुहोस्
- डाटा हेरफेरका लागि pandas, भिजुअलाइजेसनका लागि matplotlib प्रयोग गर्नुहोस्
- सामान्य आयात ढाँचा:
  ```python
  import pandas as pd
  import numpy as np
  import matplotlib.pyplot as plt
  ```

### जाभास्क्रिप्ट/Vue.js
- Vue.js 2 शैली गाइड र उत्तम अभ्यासहरू पालना गर्नुहोस्
- ESLint कन्फिगरेसन `quiz-app/package.json` मा
- Vue एकल-फाइल कम्पोनेन्टहरू (.vue फाइलहरू) प्रयोग गर्नुहोस्
- कम्पोनेन्ट-आधारित आर्किटेक्चर कायम गर्नुहोस्
- परिवर्तनहरू प्रतिबद्ध गर्नु अघि `npm run lint` चलाउनुहोस्

### Markdown डकुमेन्टेसन
- स्पष्ट शीर्षकको पदानुक्रम (# ## ### आदि) प्रयोग गर्नुहोस्
- भाषा निर्दिष्टकर्ताहरू सहित कोड ब्लकहरू समावेश गर्नुहोस्
- छविहरूको लागि alt टेक्स्ट थप्नुहोस्
- सम्बन्धित पाठहरू र स्रोतहरूमा लिंक गर्नुहोस्
- पढ्न सजिलो बनाउन लाइन लम्बाइ उचित राख्नुहोस्

### फाइल संगठन
- पाठ सामग्री क्रमांकित फोल्डरहरूमा (01-defining-data-science, आदि)
- समाधानहरू समर्पित `solution/` उपफोल्डरहरूमा
- अनुवादहरू अंग्रेजी संरचनालाई `translations/` फोल्डरमा मिरर गर्नुहोस्
- डाटा फाइलहरू `data/` वा पाठ-विशिष्ट फोल्डरहरूमा राख्नुहोस्

## निर्माण र परिनियोजन

### क्विज एप्लिकेसन परिनियोजन
```bash
cd quiz-app

# Build production version
npm run build

# Output is in dist/ folder
# Deploy dist/ folder to static hosting (Azure Static Web Apps, Netlify, etc.)
```

### Azure Static Web Apps परिनियोजन
क्विज-एप Azure Static Web Apps मा परिनियोजन गर्न सकिन्छ:
1. Azure Static Web App स्रोत सिर्जना गर्नुहोस्
2. GitHub रिपोजिटरीसँग जडान गर्नुहोस्
3. निर्माण सेटिङहरू कन्फिगर गर्नुहोस्:
   - एप स्थान: `quiz-app`
   - आउटपुट स्थान: `dist`
4. GitHub Actions वर्कफ्लोले पुश गर्दा स्वचालित रूपमा परिनियोजन गर्नेछ

### डकुमेन्टेसन साइट
```bash
# Build PDF from Docsify (optional)
npm run convert

# Docsify documentation is served directly from markdown files
# No build step required for deployment
# Deploy repository to static hosting with Docsify
```

### GitHub Codespaces
- रिपोजिटरीमा dev container कन्फिगरेसन समावेश छ
- Codespaces स्वचालित रूपमा पाइथन र Node.js वातावरण सेटअप गर्छ
- GitHub UI मार्फत रिपोजिटरीलाई Codespace मा खोल्नुहोस्
- सबै निर्भरता स्वचालित रूपमा स्थापना हुन्छ

## पुल अनुरोध दिशानिर्देशहरू

### पेश गर्नु अघि
```bash
# For Vue.js changes in quiz-app
cd quiz-app
npm run lint
npm run build

# Test changes locally
npm run serve
```

### PR शीर्षक ढाँचा
- स्पष्ट, वर्णनात्मक शीर्षकहरू प्रयोग गर्नुहोस्
- ढाँचा: `[Component] संक्षिप्त विवरण`
- उदाहरणहरू:
  - `[Lesson 7] पाइथन नोटबुक आयात त्रुटि सुधार गर्नुहोस्`
  - `[Quiz App] जर्मन अनुवाद थप्नुहोस्`
  - `[Docs] नयाँ पूर्वापेक्षाहरू सहित README अपडेट गर्नुहोस्`

### आवश्यक जाँचहरू
- सुनिश्चित गर्नुहोस् कि सबै कोड त्रुटि बिना चल्छ
- नोटबुकहरू पूर्ण रूपमा कार्यान्वयन भएको पुष्टि गर्नुहोस्
- Vue.js एपहरू सफलतापूर्वक निर्माण भएको सुनिश्चित गर्नुहोस्
- डकुमेन्टेसन लिंकहरू काम गरिरहेको जाँच गर्नुहोस्
- क्विज एप्लिकेसन परीक्षण गर्नुहोस् यदि संशोधित गरिएको छ भने
- अनुवादहरूले निरन्तर संरचना कायम राखेको पुष्टि गर्नुहोस्

### योगदान दिशानिर्देशहरू
- विद्यमान कोड शैली र ढाँचाहरू पालना गर्नुहोस्
- जटिल तर्कका लागि व्याख्यात्मक टिप्पणीहरू थप्नुहोस्
- सम्बन्धित डकुमेन्टेसन अपडेट गर्नुहोस्
- लागू भएमा विभिन्न पाठ मोड्युलहरूमा परिवर्तनहरू परीक्षण गर्नुहोस्
- CONTRIBUTING.md फाइल समीक्षा गर्नुहोस्

## थप नोटहरू

### सामान्य प्रयोग गरिएका लाइब्रेरीहरू
- **pandas**: डाटा हेरफेर र विश्लेषण
- **numpy**: संख्यात्मक कम्प्युटिङ
- **matplotlib**: डाटा भिजुअलाइजेसन र प्लटिङ
- **seaborn**: सांख्यिकीय डाटा भिजुअलाइजेसन (केही पाठहरू)
- **scikit-learn**: मेसिन लर्निङ (उन्नत पाठहरू)

### डाटा फाइलहरूसँग काम गर्दै
- डाटा फाइलहरू `data/` फोल्डर वा पाठ-विशिष्ट निर्देशिकाहरूमा अवस्थित छन्
- अधिकांश नोटबुकहरूले डाटा फाइलहरू सापेक्ष पथहरूमा अपेक्षा गर्छन्
- CSV फाइलहरू प्राथमिक डाटा ढाँचा हुन्
- केही पाठहरूले गैर-संबंधित डाटा उदाहरणहरूको लागि JSON प्रयोग गर्छन्

### बहुभाषी समर्थन
- ४०+ भाषा अनुवादहरू स्वचालित GitHub Actions मार्फत
- अनुवाद वर्कफ्लो `.github/workflows/co-op-translator.yml` मा
- अनुवादहरू `translations/` फोल्डरमा भाषा कोडहरूसहित
- क्विज अनुवादहरू `quiz-app/src/assets/translations/` मा

### विकास वातावरण विकल्पहरू
1. **स्थानीय विकास**: पाइथन, जुपिटर, Node.js स्थानीय रूपमा स्थापना गर्नुहोस्
2. **GitHub Codespaces**: क्लाउड-आधारित तत्काल विकास वातावरण
3. **VS Code Dev Containers**: स्थानीय कन्टेनर-आधारित विकास
4. **Binder**: क्लाउडमा नोटबुकहरू सुरु गर्नुहोस् (यदि कन्फिगर गरिएको छ भने)

### पाठ सामग्री दिशानिर्देशहरू
- प्रत्येक पाठ स्वतन्त्र छ तर अघिल्लो अवधारणाहरूमा आधारित छ
- पाठ अघि क्विजहरूले पूर्व ज्ञान परीक्षण गर्छन्
- पाठ पछि क्विजहरूले सिकाइलाई सुदृढ पार्छन्
- असाइनमेन्टहरूले व्यावहारिक अभ्यास प्रदान गर्छन्
- स्केच नोटहरूले भिजुअल सारांश प्रदान गर्छन्

### सामान्य समस्याहरूको समाधान

**जुपिटर कर्नेल समस्याहरू:**
```bash
# Ensure correct kernel is installed
python -m ipykernel install --user --name=datascience
```

**npm स्थापना असफलता:**
```bash
# Clear npm cache and retry
npm cache clean --force
rm -rf node_modules package-lock.json
npm install
```

**नोटबुकहरूमा आयात त्रुटिहरू:**
- सुनिश्चित गर्नुहोस् कि सबै आवश्यक लाइब्रेरीहरू स्थापना भएका छन्
- पाइथन संस्करण अनुकूलता जाँच गर्नुहोस् (पाइथन ३.७+ सिफारिस गरिएको)
- भर्चुअल वातावरण सक्रिय भएको सुनिश्चित गर्नुहोस्

**Docsify लोड हुँदै छैन:**
- सुनिश्चित गर्नुहोस् कि तपाईं रिपोजिटरी रूटबाट सेवा गर्दै हुनुहुन्छ
- जाँच गर्नुहोस् कि `index.html` अवस्थित छ
- उचित नेटवर्क पहुँच सुनिश्चित गर्नुहोस् (पोर्ट ३०००)

### प्रदर्शन विचारहरू
- ठूलो डाटासेटहरू नोटबुकहरूमा लोड गर्न समय लाग्न सक्छ
- जटिल प्लटहरूको लागि भिजुअलाइजेसन प्रस्तुत गर्न ढिलो हुन सक्छ
- Vue.js dev सर्भरले छिटो पुनरावृत्तिका लागि हट-रिलोड सक्षम गर्दछ
- उत्पादन निर्माणहरू अनुकूलित र मिनिफाइड छन्

### सुरक्षा नोटहरू
- कुनै संवेदनशील डाटा वा प्रमाणहरू प्रतिबद्ध गर्नु हुँदैन
- क्लाउड पाठहरूमा कुनै पनि API कुञ्जीहरूको लागि वातावरण चरहरू प्रयोग गर्नुहोस्
- Azure-सम्बन्धित पाठहरूले Azure खाता प्रमाणहरू आवश्यक हुन सक्छ
- सुरक्षा प्याचहरूको लागि निर्भरता अद्यावधिक राख्नुहोस्

## अनुवादहरूमा योगदान
- स्वचालित अनुवादहरू GitHub Actions मार्फत व्यवस्थापन गरिन्छ
- अनुवाद सटीकताका लागि म्यानुअल सुधारहरू स्वागतयोग्य छन्
- विद्यमान अनुवाद फोल्डर संरचना पालना गर्नुहोस्
- क्विज लिंकहरूमा भाषा प्यारामिटर समावेश गर्नुहोस्: `?loc=fr`
- अनुवादित पाठहरू सही रूपमा प्रस्तुत भएको परीक्षण गर्नुहोस्

## सम्बन्धित स्रोतहरू
- मुख्य पाठ्यक्रम: https://aka.ms/datascience-beginners
- माइक्रोसफ्ट सिकाइ: https://docs.microsoft.com/learn/
- विद्यार्थी हब: https://docs.microsoft.com/learn/student-hub
- छलफल फोरम: https://github.com/microsoft/Data-Science-For-Beginners/discussions
- अन्य माइक्रोसफ्ट पाठ्यक्रमहरू: ML for Beginners, AI for Beginners, Web Dev for Beginners

## परियोजना मर्मत
- सामग्रीलाई अद्यावधिक राख्न नियमित अपडेटहरू
- समुदाय योगदानहरू स्वागतयोग्य छन्
- मुद्दाहरू GitHub मा ट्र्याक गरिन्छ
- PRs पाठ्यक्रम मर्मतकर्ताहरूद्वारा समीक्षा गरिन्छ
- मासिक सामग्री समीक्षा र अपडेटहरू

---

**अस्वीकरण**:  
यो दस्तावेज़ AI अनुवाद सेवा [Co-op Translator](https://github.com/Azure/co-op-translator) प्रयोग गरेर अनुवाद गरिएको हो। हामी यथार्थताको लागि प्रयास गर्छौं, तर कृपया ध्यान दिनुहोस् कि स्वचालित अनुवादमा त्रुटिहरू वा अशुद्धताहरू हुन सक्छ। मूल दस्तावेज़ यसको मातृभाषामा आधिकारिक स्रोत मानिनुपर्छ। महत्वपूर्ण जानकारीको लागि, व्यावसायिक मानव अनुवाद सिफारिस गरिन्छ। यस अनुवादको प्रयोगबाट उत्पन्न हुने कुनै पनि गलतफहमी वा गलत व्याख्याको लागि हामी जिम्मेवार हुनेछैनौं।