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

AGENTS.md

திட்டத்தின் மேற்பார்வை

தரவியல் அறிவியல் தொடக்கத்திற்கான பாடத்திட்டம் மைக்ரோசாஃப்ட் Azure Cloud Advocates மூலம் உருவாக்கப்பட்ட 10 வாரங்கள், 20 பாடங்கள் கொண்ட ஒரு விரிவான பாடத்திட்டமாகும். இந்த களஞ்சியமானது திட்ட அடிப்படையிலான பாடங்கள் மூலம் தரவியல் அறிவியல் அடிப்படை கருத்துகளை கற்றுக்கொடுக்க ஒரு கற்றல் வளமாக செயல்படுகிறது. இதில் Jupyter நோட்புக்குகள், இடையூறு கேள்விகள் மற்றும் நடைமுறை பணிகள் அடங்கும்.

முக்கிய தொழில்நுட்பங்கள்:

• Jupyter நோட்புக்குகள்: Python 3 பயன்படுத்தி முதன்மை கற்றல் ஊடகம்
• Python நூலகங்கள்: pandas, numpy, matplotlib தரவுகளை பகுப்பாய்வு மற்றும் காட்சிப்படுத்துவதற்காக
• Vue.js 2: கேள்வி பயன்பாடு (quiz-app கோப்புறை)
• Docsify: ஆவணத்தள உருவாக்கி ஆஃப்லைன் அணுகலுக்கு
• Node.js/npm: JavaScript கூறுகளுக்கான தொகுப்பு மேலாண்மை
• Markdown: அனைத்து பாடத்திட்ட உள்ளடக்கம் மற்றும் ஆவணங்கள்

கட்டமைப்பு:

• பல மொழிகளில் கல்வி களஞ்சியம், விரிவான மொழிபெயர்ப்புகளுடன்
• பாடத்திட்ட தொகுதிகளாக அமைக்கப்பட்டுள்ளது (1-Introduction முதல் 6-Data-Science-In-Wild வரை)
• ஒவ்வொரு பாடத்திலும் README, நோட்புக்குகள், பணிகள் மற்றும் கேள்விகள் அடங்கும்
• தனித்துவமான Vue.js கேள்வி பயன்பாடு முன்/பின் பாடத்திட்ட மதிப்பீடுகளுக்காக
• GitHub Codespaces மற்றும் VS Code dev containers ஆதரவு

அமைப்பு கட்டளைகள்

களஞ்சிய அமைப்பு

# Clone the repository (if not already cloned)
git clone https://github.com/microsoft/Data-Science-For-Beginners.git
cd Data-Science-For-Beginners

Python சூழல் அமைப்பு

# 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

கேள்வி பயன்பாடு அமைப்பு

# 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 ஆவணத்தள சேவையகம்

# Install Docsify globally
npm install -g docsify-cli

# Serve documentation locally
docsify serve

# Documentation will be available at localhost:3000

காட்சிப்படுத்தல் திட்டங்கள் அமைப்பு

உதாரணமாக meaningful-visualizations (பாடம் 13):

# 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

மேம்பாட்டு பணிச்செலுத்தல்

Jupyter நோட்புக்குகளுடன் வேலை செய்வது

1. களஞ்சியத்தின் மூலத்தில் Jupyter தொடங்கவும்: jupyter notebook
2. தேவையான பாடத்திட்ட கோப்புறைக்கு செல்லவும்
3. .ipynb கோப்புகளை திறந்து பயிற்சிகளை மேற்கொள்ளவும்
4. நோட்புக்குகள் விளக்கங்களுடன் மற்றும் குறியீட்டு செல்களுடன் தனித்துவமாக உள்ளன
5. பெரும்பாலான நோட்புக்குகள் pandas, numpy, matplotlib பயன்படுத்துகின்றன - இவை நிறுவப்பட்டுள்ளதா என்பதை உறுதிப்படுத்தவும்

பாடத்திட்ட அமைப்பு

ஒவ்வொரு பாடத்திலும் பொதுவாக:

• README.md - கோர்வை மற்றும் உதாரணங்களுடன் முக்கிய பாடத்திட்ட உள்ளடக்கம்
• notebook.ipynb - நடைமுறை Jupyter நோட்புக்க பயிற்சிகள்
• assignment.ipynb அல்லது assignment.md - பயிற்சி பணிகள்
• solution/ கோப்புறை - தீர்வு நோட்புக்குகள் மற்றும் குறியீடு
• images/ கோப்புறை - ஆதரவு காட்சி பொருட்கள்

கேள்வி பயன்பாட்டின் மேம்பாடு

• Vue.js 2 பயன்பாடு மேம்பாட்டின் போது தானியங்கி புதுப்பிப்பு
• கேள்விகள் quiz-app/src/assets/translations/ இல் சேமிக்கப்படுகின்றன
• ஒவ்வொரு மொழிக்கும் தனித்துவமான மொழிபெயர்ப்பு கோப்புறை உள்ளது (en, fr, es, போன்றவை)
• கேள்வி எண்கள் 0 முதல் 39 வரை தொடங்குகின்றன (மொத்தம் 40 கேள்விகள்)

மொழிபெயர்ப்புகளைச் சேர்த்தல்

• மொழிபெயர்ப்புகள் translations/ கோப்புறையில் களஞ்சியத்தின் மூலத்தில் உள்ளன
• ஒவ்வொரு மொழிக்கும் ஆங்கிலத்திலிருந்து பிரதிபலிக்கப்படும் முழு பாடத்திட்ட அமைப்பு உள்ளது
• GitHub Actions மூலம் தானியங்கி மொழிபெயர்ப்பு (co-op-translator.yml)

சோதனை வழிமுறைகள்

கேள்வி பயன்பாட்டின் சோதனை

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

நோட்புக்குகளின் சோதனை

• நோட்புக்குகளுக்கு தானியங்கி சோதனை அமைப்பு இல்லை
• கையேடு மூலம் சரிபார்ப்பு: எந்தவிதமான பிழைகளும் இல்லாமல் அனைத்து செல்களையும் தொடர்ச்சியாக இயக்கவும்
• தரவுக் கோப்புகள் அணுகக்கூடியவையாக உள்ளதா மற்றும் வெளியீடுகள் சரியாக உருவாக்கப்படுகிறதா என்பதை உறுதிப்படுத்தவும்
• காட்சிகள் சரியாக உருவாகின்றனவா என்பதை சரிபார்க்கவும்

ஆவண சோதனை

# Verify Docsify renders correctly
docsify serve

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

குறியீட்டு தரச் சோதனைகள்

# 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

குறியீட்டு பாணி வழிகாட்டுதல்கள்

Python (Jupyter நோட்புக்குகள்)

• Python குறியீட்டுக்கு PEP 8 பாணி வழிகாட்டுதல்களை பின்பற்றவும்
• பகுப்பாய்வு செய்யப்படும் தரவுகளை விளக்கக்கூடிய தெளிவான மாறி பெயர்களைப் பயன்படுத்தவும்
• குறியீட்டு செல்களுக்கு முன் விளக்கங்களுடன் Markdown செல்களை சேர்க்கவும்
• ஒற்றை கருத்துகள் அல்லது செயல்பாடுகளுக்கு மையமாக குறியீட்டு செல்களை வைத்திருக்கவும்
• pandas தரவுகளை மாற்றுவதற்கு, matplotlib காட்சிப்படுத்துவதற்கு பயன்படுத்தவும்
• பொதுவான இறக்குமதி முறை:

  import pandas as pd
  import numpy as np
  import matplotlib.pyplot as plt
  

JavaScript/Vue.js

• Vue.js 2 பாணி வழிகாட்டுதல்கள் மற்றும் சிறந்த நடைமுறைகளை பின்பற்றவும்
• ESLint கட்டமைப்பு quiz-app/package.json இல் உள்ளது
• Vue ஒற்றை கோப்பு கூறுகளை (.vue கோப்புகள்) பயன்படுத்தவும்
• கூறு அடிப்படையிலான கட்டமைப்பை பராமரிக்கவும்
• மாற்றங்களைச் சேர்க்கும் முன் npm run lint இயக்கவும்

Markdown ஆவணங்கள்

• தெளிவான தலைப்புகள் வரிசையை (# ## ### போன்றவை) பயன்படுத்தவும்
• மொழி குறிப்புகளுடன் குறியீட்டு தொகுதிகளைச் சேர்க்கவும்
• படங்களுக்கு மாற்று உரையைச் சேர்க்கவும்
• தொடர்புடைய பாடங்கள் மற்றும் வளங்களுக்கு இணைப்புகளைச் சேர்க்கவும்
• வாசிக்க எளிதாக வரி நீளங்களை பராமரிக்கவும்

கோப்பு அமைப்பு

• பாடத்திட்ட உள்ளடக்கம் எண் கொண்ட கோப்புறைகளில் (01-defining-data-science, போன்றவை) உள்ளது
• தீர்வுகள் தனித்துவமான solution/ துணை கோப்புறைகளில் உள்ளன
• மொழிபெயர்ப்புகள் ஆங்கில அமைப்பை பிரதிபலிக்கும் translations/ கோப்புறையில் உள்ளன
• தரவுக் கோப்புகள் data/ அல்லது பாடத்திட்ட குறிப்பிட்ட கோப்புறைகளில் உள்ளன

கட்டமைப்பு மற்றும் வெளியீடு

கேள்வி பயன்பாட்டின் வெளியீடு

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 பணிச்செலுத்தல் push செய்யும் போது தானியங்கி வெளியீடு செய்யும்

ஆவணத்தளத்திற்கான Docsify

# 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 தானியங்கி Python மற்றும் Node.js சூழலை அமைக்கிறது
• GitHub UI மூலம் Codespace இல் களஞ்சியத்தைத் திறக்கவும்
• அனைத்து சார்புகள் தானியங்கி நிறுவப்படும்

Pull Request வழிகாட்டுதல்கள்

சமர்ப்பிக்கும் முன்

# 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] Python நோட்புக்கில் இறக்குமதி பிழையை சரிசெய்க
  • [Quiz App] ஜெர்மன் மொழிபெயர்ப்பைச் சேர்க்கவும்
  • [Docs] புதிய முன்னோட்டங்களுடன் README புதுப்பிக்கவும்

தேவையான சோதனைகள்

• அனைத்து குறியீடும் பிழைகள் இல்லாமல் இயங்குவதை உறுதிப்படுத்தவும்
• நோட்புக்குகள் முழுமையாக செயல்படுவதை உறுதிப்படுத்தவும்
• Vue.js பயன்பாடுகள் வெற்றிகரமாக கட்டமைக்கப்படுவதை உறுதிப்படுத்தவும்
• ஆவண இணைப்புகள் வேலை செய்கிறதா என்பதைச் சரிபார்க்கவும்
• கேள்வி பயன்பாட்டை மாற்றியிருந்தால் சோதிக்கவும்
• மொழிபெயர்ப்புகள் ஒரே அமைப்பை பராமரிக்கிறதா என்பதை உறுதிப்படுத்தவும்

பங்களிப்பு வழிகாட்டுதல்கள்

• உள்ள குறியீட்டு பாணி மற்றும் முறைமைகளை பின்பற்றவும்
• சிக்கலான தர்க்கத்திற்கான விளக்கக் கருத்துகளைச் சேர்க்கவும்
• தொடர்புடைய ஆவணங்களைப் புதுப்பிக்கவும்
• தேவையான பாடத்திட்ட தொகுதிகளில் மாற்றங்களைச் சோதிக்கவும்
• CONTRIBUTING.md கோப்பை மதிப்பாய்வு செய்யவும்

கூடுதல் குறிப்புகள்

பொதுவாக பயன்படுத்தப்படும் நூலகங்கள்

• pandas: தரவுகளை மாற்றம் மற்றும் பகுப்பாய்வு
• numpy: எண் கணினி
• matplotlib: தரவுகளை காட்சிப்படுத்தல் மற்றும் வரைபடம்
• seaborn: புள்ளியியல் தரவுகளை காட்சிப்படுத்தல் (சில பாடங்கள்)
• scikit-learn: இயந்திர கற்றல் (மேம்பட்ட பாடங்கள்)

தரவுக் கோப்புகளுடன் வேலை செய்வது

• தரவுக் கோப்புகள் data/ கோப்புறையில் அல்லது பாடத்திட்ட குறிப்பிட்ட கோப்புறைகளில் உள்ளன
• பெரும்பாலான நோட்புக்குகள் தொடர்புடைய பாதைகளில் தரவுக் கோப்புகளை எதிர்பார்க்கின்றன
• CSV கோப்புகள் முதன்மை தரவுப் வடிவமாகும்
• சில பாடங்கள் JSON ஐ தொடர்பற்ற தரவுக்கான உதாரணமாக பயன்படுத்துகின்றன

பல மொழி ஆதரவு

• 40+ மொழி மொழிபெயர்ப்புகள் தானியங்கி GitHub Actions மூலம்
• மொழிபெயர்ப்பு பணிச்செலுத்தல் .github/workflows/co-op-translator.yml இல் உள்ளது
• மொழிபெயர்ப்புகள் translations/ கோப்புறையில் மொழி குறியீடுகளுடன் உள்ளன
• கேள்வி மொழிபெயர்ப்புகள் quiz-app/src/assets/translations/ இல் உள்ளன

மேம்பாட்டு சூழல் விருப்பங்கள்

1. உள்ளூர் மேம்பாடு: Python, Jupyter, Node.js உள்ளூர் நிறுவல்
2. GitHub Codespaces: மேக அடிப்படையிலான உடனடி மேம்பாட்டு சூழல்
3. VS Code Dev Containers: உள்ளூர் கெண்டைனர் அடிப்படையிலான மேம்பாடு
4. Binder: மேகத்தில் நோட்புக்குகளைத் தொடங்கவும் (அமைக்கப்பட்டிருந்தால்)

பாடத்திட்ட உள்ளடக்க வழிகாட்டுதல்கள்

• ஒவ்வொரு பாடமும் தனித்துவமானது ஆனால் முந்தைய கருத்துகளை அடிப்படையாகக் கொண்டது
• பாடத்திற்குமுன் கேள்விகள் முந்தைய அறிவைச் சோதிக்கின்றன
• பாடத்திற்குப் பின் கேள்விகள் கற்றலை உறுதிப்படுத்துகின்றன
• பணிகள் நடைமுறை பயிற்சியை வழங்குகின்றன
• Sketchnotes காட்சி சுருக்கங்களை வழங்குகின்றன

பொதுவான பிரச்சினைகளைத் தீர்க்கும் வழிமுறைகள்

Jupyter கர்னல் பிரச்சினைகள்:

# Ensure correct kernel is installed
python -m ipykernel install --user --name=datascience

npm நிறுவல் தோல்விகள்:

# Clear npm cache and retry
npm cache clean --force
rm -rf node_modules package-lock.json
npm install

நோட்புக்குகளில் இறக்குமதி பிழைகள்:

• தேவையான அனைத்து நூலகங்களும் நிறுவப்பட்டுள்ளதா என்பதை உறுதிப்படுத்தவும்
• Python பதிப்பு பொருத்தத்தைச் சரிபார்க்கவும் (Python 3.7+ பரிந்துரைக்கப்படுகிறது)
• மெய்நிகர் சூழல் செயல்படுத்தப்பட்டுள்ளதா என்பதை உறுதிப்படுத்தவும்

Docsify சரியாக ஏற்றப்படவில்லை:

• நீங்கள் களஞ்சியத்தின் மூலத்திலிருந்து சேவை செய்கிறீர்களா என்பதை உறுதிப்படுத்தவும்
• index.html உள்ளது என்பதைச் சரிபார்க்கவும்
• சரியான நெட்வொர்க் அணுகலை உறுதிப்படுத்தவும் (port 3000)

செயல்திறன் கருத்துகள்

• பெரிய தரவுத்தொகுதிகள் நோட்புக்குகளில் ஏற்றுவதற்கு நேரம் எடுக்கலாம்
• சிக்கலான வரைபடங்களுக்கு காட்சி உருவாக்கம் மெதுவாக இருக்கலாம்
• Vue.js dev சேவையகம் விரைவான திருத்தத்திற்கான தானியங்கி புதுப்பிப்பை இயக்குகிறது
• உற்பத்தி கட்டமைப்புகள் மேம்படுத்தப்பட்டவை மற்றும் சுருக்கப்பட்டவை

பாதுகாப்பு குறிப்புகள்

• எந்தவிதமான நுணுக்கமான தரவுகள் அல்லது அங்கீகாரங்கள் Commit செய்யக்கூடாது
• மேக பாடங்களில் API விசைகளைச் சேர்க்க சூழல் மாறிகளைப் பயன்படுத்தவும்
• Azure தொடர்புடைய பாடங்கள் Azure கணக்கு அங்கீகாரங்களை தேவைப்படலாம்
• பாதுகாப்பு திருத்தங்களுக்கு சார்புகளை புதுப்பித்து வைத்திருக்கவும்

மொழிபெயர்ப்புகளுக்கு பங்களிப்பு

• தானியங்கி மொழிபெயர்ப்புகள் GitHub Actions மூலம் நிர்வகிக்கப்படுகின்றன
• மொழிபெயர்ப்பு துல்லியத்திற்கான கையேடு திருத்தங்கள் வரவேற்கப்படுகின்றன
• உள்ள மொழிபெயர்ப்பு கோப்புறை அமைப்பை பின்பற்றவும்
• கேள்வி இணைப்புகளை மொழி அளவுருவுடன் புதுப்பிக்கவும்: ?loc=fr
• மொழிபெயர்க்கப்பட்ட பாடங்கள் சரியாக ஏற்றப்படுகிறதா என்பதைச் சோதிக்கவும்

தொடர்புடைய வளங்கள்

• முக்கிய பாடத்திட்டம்: https://aka.ms/datascience-beginners
• Microsoft Learn: 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 மதிப்பாய்வு செய்யப்படும்
• மாதாந்திர உள்ளடக்க மதிப்பாய்வுகள் மற்றும் புதுப்பிப்புகள்

---

குறிப்பு:
இந்த ஆவணம் Co-op Translator என்ற AI மொழிபெயர்ப்பு சேவையைப் பயன்படுத்தி மொழிபெயர்க்கப்பட்டுள்ளது. நாங்கள் துல்லியத்திற்காக முயற்சிக்கின்றோம், ஆனால் தானியக்க மொழிபெயர்ப்புகளில் பிழைகள் அல்லது தவறான தகவல்கள் இருக்கக்கூடும் என்பதை கவனத்தில் கொள்ளவும். அதன் தாய்மொழியில் உள்ள மூல ஆவணம் அதிகாரப்பூர்வ ஆதாரமாக கருதப்பட வேண்டும். முக்கியமான தகவல்களுக்கு, தொழில்முறை மனித மொழிபெயர்ப்பு பரிந்துரைக்கப்படுகிறது. இந்த மொழிபெயர்ப்பைப் பயன்படுத்துவதால் ஏற்படும் எந்த தவறான புரிதல்கள் அல்லது தவறான விளக்கங்களுக்கு நாங்கள் பொறுப்பல்ல.