You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Data-Science-For-Beginners/translations/kn/AGENTS.md

28 KiB

AGENTS.md

ಪ್ರಾಜೆಕ್ಟ್ ಅವಲೋಕನ

ಡೇಟಾ ಸೈನ್ಸ್ ಫಾರ್ ಬಿಗಿನರ್ಸ್ ಎಂಬುದು ಮೈಕ್ರೋಸಾಫ್ಟ್ ಅಜೂರ್ ಕ್ಲೌಡ್ ಅಡ್ವೊಕೇಟ್ಸ್ ರಚಿಸಿದ ಸಮಗ್ರ 10-ವಾರ, 20-ಪಾಠಗಳ ಪಠ್ಯಕ್ರಮವಾಗಿದೆ. ಈ ರೆಪೊಸಿಟರಿ ಪ್ರಾಜೆಕ್ಟ್ ಆಧಾರಿತ ಪಾಠಗಳ ಮೂಲಕ ಮೂಲಭೂತ ಡೇಟಾ ಸೈನ್ಸ್ ತತ್ವಗಳನ್ನು ಕಲಿಸುವ ಕಲಿಕಾ ಸಂಪನ್ಮೂಲವಾಗಿದೆ, ಇದರಲ್ಲಿ ಜುಪೈಟರ್ ನೋಟ್ಬುಕ್‌ಗಳು, ಇಂಟರಾಕ್ಟಿವ್ ಕ್ವಿಜ್‌ಗಳು ಮತ್ತು ಹ್ಯಾಂಡ್ಸ್-ಆನ್ ಅಸೈನ್‌ಮೆಂಟ್‌ಗಳು ಸೇರಿವೆ.

ಪ್ರಮುಖ ತಂತ್ರಜ್ಞಾನಗಳು:

  • ಜುಪೈಟರ್ ನೋಟ್ಬುಕ್‌ಗಳು: ಪೈಥಾನ್ 3 ಬಳಸಿ ಪ್ರಾಥಮಿಕ ಕಲಿಕಾ ಮಾಧ್ಯಮ
  • ಪೈಥಾನ್ ಲೈಬ್ರರಿಗಳು: pandas, numpy, matplotlib ಡೇಟಾ ವಿಶ್ಲೇಷಣೆ ಮತ್ತು ದೃಶ್ಯೀಕರಣಕ್ಕಾಗಿ
  • Vue.js 2: ಕ್ವಿಜ್ ಅಪ್ಲಿಕೇಶನ್ (quiz-app ಫೋಲ್ಡರ್)
  • Docsify: ಆಫ್‌ಲೈನ್ ಪ್ರವೇಶಕ್ಕಾಗಿ ಡಾಕ್ಯುಮೆಂಟೇಶನ್ ಸೈಟ್ ಜನರೇಟರ್
  • Node.js/npm: ಜಾವಾಸ್ಕ್ರಿಪ್ಟ್ ಘಟಕಗಳ ಪ್ಯಾಕೇಜ್ ನಿರ್ವಹಣೆ
  • Markdown: ಎಲ್ಲಾ ಪಾಠ ವಿಷಯ ಮತ್ತು ಡಾಕ್ಯುಮೆಂಟೇಶನ್

ವಾಸ್ತುಶಿಲ್ಪ:

  • ವ್ಯಾಪಕ ಅನುವಾದಗಳೊಂದಿಗೆ ಬಹುಭಾಷಾ ಶೈಕ್ಷಣಿಕ ರೆಪೊಸಿಟರಿ
  • ಪಾಠ ಮಾಯಾಜಾಲಗಳಾಗಿ ರಚಿಸಲಾಗಿದೆ (1-ಪರಿಚಯದಿಂದ 6-ಡೇಟಾ-ಸೈನ್ಸ್-ಇನ್-ವೈಲ್ಡ್)
  • ಪ್ರತಿ ಪಾಠದಲ್ಲಿ README, ನೋಟ್ಬುಕ್‌ಗಳು, ಅಸೈನ್‌ಮೆಂಟ್‌ಗಳು ಮತ್ತು ಕ್ವಿಜ್‌ಗಳು ಸೇರಿವೆ
  • ಪೂರ್ವ/ಪೋಸ್ಟ್ ಪಾಠ ಮೌಲ್ಯಮಾಪನಕ್ಕಾಗಿ ಸ್ವತಂತ್ರ Vue.js ಕ್ವಿಜ್ ಅಪ್ಲಿಕೇಶನ್
  • GitHub Codespaces ಮತ್ತು VS Code ಡೆವ್ ಕಂಟೈನರ್‌ಗಳಿಗೆ ಬೆಂಬಲ

ಸೆಟಪ್ ಕಮಾಂಡ್‌ಗಳು

ರೆಪೊಸಿಟರಿ ಸೆಟಪ್

# ರೆಪೊಸಿಟರಿಯನ್ನು ಕ್ಲೋನ್ ಮಾಡಿ (ಇನ್ನೂ ಕ್ಲೋನ್ ಮಾಡದಿದ್ದರೆ)
git clone https://github.com/microsoft/Data-Science-For-Beginners.git
cd Data-Science-For-Beginners

ಪೈಥಾನ್ ಪರಿಸರ ಸೆಟಪ್

# ವರ್ಚುವಲ್ ಪರಿಸರವನ್ನು ರಚಿಸಿ (ಶಿಫಾರಸು ಮಾಡಲಾಗಿದೆ)
python -m venv venv
source venv/bin/activate  # ವಿಂಡೋಸ್‌ನಲ್ಲಿ: venv\Scripts\activate

# ಸಾಮಾನ್ಯ ಡೇಟಾ ಸೈನ್ಸ್ ಲೈಬ್ರರಿಗಳನ್ನು ಸ್ಥಾಪಿಸಿ (requirements.txt ಇಲ್ಲ)
pip install jupyter pandas numpy matplotlib seaborn scikit-learn

ಕ್ವಿಜ್ ಅಪ್ಲಿಕೇಶನ್ ಸೆಟಪ್

# ಕ್ವಿಜ್ ಅಪ್ಲಿಕೇಶನ್‌ಗೆ ನಾವಿಗೇಟ್ ಮಾಡಿ
cd quiz-app

# ಅವಲಂಬನೆಗಳನ್ನು ಸ್ಥಾಪಿಸಿ
npm install

# ಅಭಿವೃದ್ಧಿ ಸರ್ವರ್ ಪ್ರಾರಂಭಿಸಿ
npm run serve

# ಉತ್ಪಾದನೆಗಾಗಿ ನಿರ್ಮಿಸಿ
npm run build

# ಲಿಂಟ್ ಮಾಡಿ ಮತ್ತು ಫೈಲ್‌ಗಳನ್ನು ಸರಿಪಡಿಸಿ
npm run lint

Docsify ಡಾಕ್ಯುಮೆಂಟೇಶನ್ ಸರ್ವರ್

# ಡಾಕ್ಸಿಫೈ ಅನ್ನು ಜಾಗತಿಕವಾಗಿ ಸ್ಥಾಪಿಸಿ
npm install -g docsify-cli

# ಡಾಕ್ಯುಮೆಂಟೇಶನ್ ಅನ್ನು ಸ್ಥಳೀಯವಾಗಿ ಸೇವೆ ಮಾಡಿ
docsify serve

# ಡಾಕ್ಯುಮೆಂಟೇಶನ್ localhost:3000 ನಲ್ಲಿ ಲಭ್ಯವಿರುತ್ತದೆ

ದೃಶ್ಯೀಕರಣ ಪ್ರಾಜೆಕ್ಟ್‌ಗಳ ಸೆಟಪ್

meaningful-visualizations (ಪಾಠ 13) ಮುಂತಾದ ದೃಶ್ಯೀಕರಣ ಪ್ರಾಜೆಕ್ಟ್‌ಗಳಿಗೆ:

# ಸ್ಟಾರ್ಟರ್ ಅಥವಾ ಸೊಲ್ಯೂಶನ್ ಫೋಲ್ಡರ್‌ಗೆ ನ್ಯಾವಿಗೇಟ್ ಮಾಡಿ
cd 3-Data-Visualization/13-meaningful-visualizations/starter

# ಅವಲಂಬನೆಗಳನ್ನು ಸ್ಥಾಪಿಸಿ
npm install

# ಡೆವಲಪ್‌ಮೆಂಟ್ ಸರ್ವರ್ ಪ್ರಾರಂಭಿಸಿ
npm run serve

# ಉತ್ಪಾದನೆಗಾಗಿ ನಿರ್ಮಿಸಿ
npm run build

# ಫೈಲ್‌ಗಳನ್ನು ಲಿಂಟ್ ಮಾಡಿ
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, ಇತ್ಯಾದಿ)
  • ಕ್ವಿಜ್ ಸಂಖ್ಯೆ 0 ರಿಂದ ಪ್ರಾರಂಭವಾಗಿ 39 ರವರೆಗೆ (ಒಟ್ಟು 40 ಕ್ವಿಜ್‌ಗಳು)

ಅನುವಾದಗಳನ್ನು ಸೇರಿಸುವುದು

  • ಅನುವಾದಗಳು ರೆಪೊಸಿಟರಿ ರೂಟ್‌ನ translations/ ಫೋಲ್ಡರ್‌ನಲ್ಲಿ ಇರುತ್ತವೆ
  • ಪ್ರತಿ ಭಾಷೆಗೆ ಇಂಗ್ಲಿಷ್‌ನಿಂದ ಪೂರ್ಣ ಪಾಠ ರಚನೆ ಪ್ರತಿಬಿಂಬಿತವಾಗಿದೆ
  • GitHub Actions ಮೂಲಕ ಸ್ವಯಂಚಾಲಿತ ಅನುವಾದ (co-op-translator.yml)

ಪರೀಕ್ಷಾ ಸೂಚನೆಗಳು

ಕ್ವಿಜ್ ಅಪ್ಲಿಕೇಶನ್ ಪರೀಕ್ಷೆ

cd quiz-app

# ಲಿಂಟ್ ಪರಿಶೀಲನೆಗಳನ್ನು ನಡೆಸಿ
npm run lint

# ನಿರ್ಮಾಣ ಪ್ರಕ್ರಿಯೆಯನ್ನು ಪರೀಕ್ಷಿಸಿ
npm run build

# ಕೈಯಿಂದ ಪರೀಕ್ಷೆ: ಡೆವ್ ಸರ್ವರ್ ಪ್ರಾರಂಭಿಸಿ ಮತ್ತು ಕ್ವಿಜ್ ಕಾರ್ಯಕ್ಷಮತೆಯನ್ನು ಪರಿಶೀಲಿಸಿ
npm run serve

ನೋಟ್ಬುಕ್ ಪರೀಕ್ಷೆ

  • ನೋಟ್ಬುಕ್‌ಗಳಿಗೆ ಸ್ವಯಂಚಾಲಿತ ಪರೀಕ್ಷಾ ಫ್ರೇಮ್ವರ್ಕ್ ಇಲ್ಲ
  • ಕೈಯಿಂದ ಪರಿಶೀಲನೆ: ಎಲ್ಲಾ ಸೆಲ್‌ಗಳನ್ನು ಕ್ರಮವಾಗಿ ಓಡಿಸಿ ದೋಷಗಳಿಲ್ಲದಿರುವುದನ್ನು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ
  • ಡೇಟಾ ಫೈಲ್‌ಗಳು ಲಭ್ಯವಿರುವುದನ್ನು ಮತ್ತು ಔಟ್‌ಪುಟ್‌ಗಳು ಸರಿಯಾಗಿ ಉತ್ಪಾದಿತವಾಗಿರುವುದನ್ನು ಪರಿಶೀಲಿಸಿ
  • ದೃಶ್ಯೀಕರಣಗಳು ಸರಿಯಾಗಿ ರೆಂಡರ್ ಆಗುತ್ತಿವೆಯೇ ಎಂದು ಪರಿಶೀಲಿಸಿ

ಡಾಕ್ಯುಮೆಂಟೇಶನ್ ಪರೀಕ್ಷೆ

# ಡಾಕ್ಸಿಫೈ ಸರಿಯಾಗಿ ರೆಂಡರ್ ಆಗುತ್ತದೆಯೇ ಎಂದು ಪರಿಶೀಲಿಸಿ
docsify serve

# ವಿಷಯವನ್ನು ನಾವಿಗೇಟ್ ಮಾಡಿ ಮುರಿದ ಲಿಂಕ್‌ಗಳನ್ನು ಕೈಯಿಂದ ಪರಿಶೀಲಿಸಿ
# ರೆಂಡರ್ ಮಾಡಿದ ಡಾಕ್ಯುಮೆಂಟೇಶನ್‌ನಲ್ಲಿ ಎಲ್ಲಾ ಪಾಠ ಲಿಂಕ್‌ಗಳು ಕಾರ್ಯನಿರ್ವಹಿಸುತ್ತವೆಯೇ ಎಂದು ಪರಿಶೀಲಿಸಿ

ಕೋಡ್ ಗುಣಮಟ್ಟ ಪರಿಶೀಲನೆ

# Vue.js ಪ್ರಾಜೆಕ್ಟ್‌ಗಳು (quiz-app ಮತ್ತು ದೃಶ್ಯೀಕರಣ ಪ್ರಾಜೆಕ್ಟ್‌ಗಳು)
cd quiz-app  # ಅಥವಾ ದೃಶ್ಯೀಕರಣ ಪ್ರಾಜೆಕ್ಟ್ ಫೋಲ್ಡರ್
npm run lint

# ಪೈಥಾನ್ ನೋಟ್ಬುಕ್‌ಗಳು - ಕೈಯಿಂದ ಪರಿಶೀಲನೆ ಶಿಫಾರಸು ಮಾಡಲಾಗಿದೆ
# ಆಮದುಗಳು ಸರಿಯಾಗಿ ಕಾರ್ಯನಿರ್ವಹಿಸುತ್ತವೆ ಮತ್ತು ಸೆಲ್‌ಗಳು ದೋಷರಹಿತವಾಗಿ ಕಾರ್ಯನಿರ್ವಹಿಸುತ್ತವೆ ಎಂದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ

ಕೋಡ್ ಶೈಲಿ ಮಾರ್ಗಸೂಚಿಗಳು

ಪೈಥಾನ್ (ಜುಪೈಟರ್ ನೋಟ್ಬುಕ್‌ಗಳು)

  • ಪೈಥಾನ್ ಕೋಡ್‌ಗೆ PEP 8 ಶೈಲಿ ಮಾರ್ಗಸೂಚಿಗಳನ್ನು ಅನುಸರಿಸಿ
  • ವಿಶ್ಲೇಷಿಸುತ್ತಿರುವ ಡೇಟಾವನ್ನು ವಿವರಿಸುವ ಸ್ಪಷ್ಟ ವ್ಯತ್ಯಯ ಹೆಸರುಗಳನ್ನು ಬಳಸಿ
  • ಕೋಡ್ ಸೆಲ್‌ಗಳ ಮುಂಚೆ ವಿವರಣೆಗಳೊಂದಿಗೆ ಮಾರ್ಕ್‌ಡೌನ್ ಸೆಲ್‌ಗಳನ್ನು ಸೇರಿಸಿ
  • ಕೋಡ್ ಸೆಲ್‌ಗಳನ್ನು ಏಕಾಂಗಿ ತತ್ವಗಳು ಅಥವಾ ಕಾರ್ಯಾಚರಣೆಗಳ ಮೇಲೆ ಕೇಂದ್ರೀಕರಿಸಿ
  • ಡೇಟಾ ಸಂಚಲನಕ್ಕೆ pandas, ದೃಶ್ಯೀಕರಣಕ್ಕೆ matplotlib ಬಳಸಿ
  • ಸಾಮಾನ್ಯ ಆಮದು ಮಾದರಿ:
    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 ಓಡಿಸಿ

ಮಾರ್ಕ್‌ಡೌನ್ ಡಾಕ್ಯುಮೆಂಟೇಶನ್

  • ಸ್ಪಷ್ಟ ಶೀರ್ಷಿಕೆ ಹೈರಾರ್ಕಿಯನ್ನು ಬಳಸಿ (# ## ### ಇತ್ಯಾದಿ)
  • ಭಾಷಾ ಸೂಚಕಗಳೊಂದಿಗೆ ಕೋಡ್ ಬ್ಲಾಕ್‌ಗಳನ್ನು ಸೇರಿಸಿ
  • ಚಿತ್ರಗಳಿಗೆ alt ಪಠ್ಯವನ್ನು ಸೇರಿಸಿ
  • ಸಂಬಂಧಿತ ಪಾಠಗಳು ಮತ್ತು ಸಂಪನ್ಮೂಲಗಳಿಗೆ ಲಿಂಕ್ ಮಾಡಿ
  • ಓದಲು ಸುಲಭವಾಗುವಂತೆ ಸಾಲಿನ ಉದ್ದವನ್ನು ಯುಕ್ತವಾಗಿ ಇಡಿ

ಫೈಲ್ ಸಂಘಟನೆ

  • ಪಾಠ ವಿಷಯ ಸಂಖ್ಯಿತ ಫೋಲ್ಡರ್‌ಗಳಲ್ಲಿ (01-defining-data-science ಮುಂತಾದವು)
  • ಪರಿಹಾರಗಳು ಸಮರ್ಪಿತ solution/ ಉಪಫೋಲ್ಡರ್‌ಗಳಲ್ಲಿ
  • ಅನುವಾದಗಳು ಇಂಗ್ಲಿಷ್ ರಚನೆಯನ್ನು ಪ್ರತಿಬಿಂಬಿಸುವ translations/ ಫೋಲ್ಡರ್‌ನಲ್ಲಿ
  • ಡೇಟಾ ಫೈಲ್‌ಗಳನ್ನು data/ ಅಥವಾ ಪಾಠ-ನಿರ್ದಿಷ್ಟ ಫೋಲ್ಡರ್‌ಗಳಲ್ಲಿ ಇಡಿ

ನಿರ್ಮಾಣ ಮತ್ತು ನಿಯೋಜನೆ

ಕ್ವಿಜ್ ಅಪ್ಲಿಕೇಶನ್ ನಿಯೋಜನೆ

cd quiz-app

# ಉತ್ಪಾದನಾ ಆವೃತ್ತಿಯನ್ನು ನಿರ್ಮಿಸಿ
npm run build

# ಔಟ್‌ಪುಟ್ dist/ ಫೋಲ್ಡರ್‌ನಲ್ಲಿ ಇದೆ
# dist/ ಫೋಲ್ಡರ್ ಅನ್ನು ಸ್ಥಿರ ಹೋಸ್ಟಿಂಗ್‌ಗೆ ನಿಯೋಜಿಸಿ (Azure Static Web Apps, Netlify, ಇತ್ಯಾದಿ)

ಅಜೂರ್ ಸ್ಟ್ಯಾಟಿಕ್ ವೆಬ್ ಅಪ್ಲಿಕೇಶನ್ ನಿಯೋಜನೆ

quiz-app ಅನ್ನು ಅಜೂರ್ ಸ್ಟ್ಯಾಟಿಕ್ ವೆಬ್ ಅಪ್ಲಿಕೇಶನ್‌ಗಳಿಗೆ ನಿಯೋಜಿಸಬಹುದು:

  1. ಅಜೂರ್ ಸ್ಟ್ಯಾಟಿಕ್ ವೆಬ್ ಅಪ್ಲಿಕೇಶನ್ ಸಂಪನ್ಮೂಲವನ್ನು ರಚಿಸಿ
  2. GitHub ರೆಪೊಸಿಟರಿಯನ್ನು ಸಂಪರ್ಕಿಸಿ
  3. ನಿರ್ಮಾಣ ಸೆಟ್ಟಿಂಗ್‌ಗಳನ್ನು ಸಂರಚಿಸಿ:
    • ಅಪ್ಲಿಕೇಶನ್ ಸ್ಥಳ: quiz-app
    • ಔಟ್‌ಪುಟ್ ಸ್ಥಳ: dist
  4. GitHub Actions ಕಾರ್ಯಪ್ರವಾಹವು ಪುಷ್ ಮಾಡಿದಾಗ ಸ್ವಯಂಚಾಲಿತವಾಗಿ ನಿಯೋಜಿಸುತ್ತದೆ

ಡಾಕ್ಯುಮೆಂಟೇಶನ್ ಸೈಟ್

# ಡಾಕ್ಸಿಫಿಯಿಂದ PDF ನಿರ್ಮಿಸಿ (ಐಚ್ಛಿಕ)
npm run convert

# ಡಾಕ್ಸಿಫಿ ಡಾಕ್ಯುಮೆಂಟೇಶನ್ ನೇರವಾಗಿ ಮಾರ್ಕ್‌ಡೌನ್ ಫೈಲ್‌ಗಳಿಂದ ಸೇವೆ ಮಾಡಲಾಗುತ್ತದೆ
# ನಿಯೋಜನೆಗಾಗಿ ಯಾವುದೇ ನಿರ್ಮಾಣ ಹಂತ ಅಗತ್ಯವಿಲ್ಲ
# ಡಾಕ್ಸಿಫಿ ಬಳಸಿ ರೆಪೊಸಿಟರಿಯನ್ನು ಸ್ಥಿರ ಹೋಸ್ಟಿಂಗ್‌ಗೆ ನಿಯೋಜಿಸಿ

GitHub Codespaces

  • ರೆಪೊಸಿಟರಿಯಲ್ಲಿ ಡೆವ್ ಕಂಟೈನರ್ ಸಂರಚನೆ ಸೇರಿದೆ
  • Codespaces ಸ್ವಯಂಚಾಲಿತವಾಗಿ ಪೈಥಾನ್ ಮತ್ತು Node.js ಪರಿಸರವನ್ನು ಸೆಟ್ ಮಾಡುತ್ತದೆ
  • GitHub UI ಮೂಲಕ Codespace ನಲ್ಲಿ ರೆಪೊಸಿಟರಿ ತೆರೆಯಿರಿ
  • ಎಲ್ಲಾ ಅವಲಂಬನೆಗಳು ಸ್ವಯಂಚಾಲಿತವಾಗಿ ಸ್ಥಾಪಿತವಾಗುತ್ತವೆ

ಪುಲ್ ರಿಕ್ವೆಸ್ಟ್ ಮಾರ್ಗಸೂಚಿಗಳು

ಸಲ್ಲಿಸುವ ಮೊದಲು

# quiz-app ನಲ್ಲಿ Vue.js ಬದಲಾವಣೆಗಳಿಗೆ
cd quiz-app
npm run lint
npm run build

# ಬದಲಾವಣೆಗಳನ್ನು ಸ್ಥಳೀಯವಾಗಿ ಪರೀಕ್ಷಿಸಿ
npm run serve

PR ಶೀರ್ಷಿಕೆ ಸ್ವರೂಪ

  • ಸ್ಪಷ್ಟ, ವಿವರಣಾತ್ಮಕ ಶೀರ್ಷಿಕೆಗಳನ್ನು ಬಳಸಿ
  • ಸ್ವರೂಪ: [Component] ಸಂಕ್ಷಿಪ್ತ ವಿವರಣೆ
  • ಉದಾಹರಣೆಗಳು:
    • [Lesson 7] ಪೈಥಾನ್ ನೋಟ್ಬುಕ್ ಆಮದು ದೋಷವನ್ನು ಸರಿಪಡಿಸಿ
    • [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. ಸ್ಥಳೀಯ ಅಭಿವೃದ್ಧಿ: ಪೈಥಾನ್, ಜುಪೈಟರ್, Node.js ಸ್ಥಳೀಯವಾಗಿ ಸ್ಥಾಪಿಸಿ
  2. GitHub Codespaces: ಕ್ಲೌಡ್ ಆಧಾರಿತ ತಕ್ಷಣದ ಅಭಿವೃದ್ಧಿ ಪರಿಸರ
  3. VS Code ಡೆವ್ ಕಂಟೈನರ್‌ಗಳು: ಸ್ಥಳೀಯ ಕಂಟೈನರ್ ಆಧಾರಿತ ಅಭಿವೃದ್ಧಿ
  4. ಬಿಂಡರ್: ಕ್ಲೌಡ್‌ನಲ್ಲಿ ನೋಟ್ಬುಕ್‌ಗಳನ್ನು ಪ್ರಾರಂಭಿಸಿ (ಸೆಟ್ ಮಾಡಿದರೆ)

ಪಾಠ ವಿಷಯ ಮಾರ್ಗಸೂಚಿಗಳು

  • ಪ್ರತಿ ಪಾಠ ಸ್ವತಂತ್ರವಾಗಿದ್ದು ಹಿಂದಿನ ತತ್ವಗಳ ಮೇಲೆ ನಿರ್ಮಿತವಾಗಿದೆ
  • ಪೂರ್ವ ಪಾಠ ಕ್ವಿಜ್‌ಗಳು ಹಿಂದಿನ ಜ್ಞಾನವನ್ನು ಪರೀಕ್ಷಿಸುತ್ತವೆ
  • ಪೋಸ್ಟ್ ಪಾಠ ಕ್ವಿಜ್‌ಗಳು ಕಲಿಕೆಯನ್ನು ಬಲಪಡಿಸುತ್ತವೆ
  • ಅಸೈನ್‌ಮೆಂಟ್‌ಗಳು ಹ್ಯಾಂಡ್ಸ್-ಆನ್ ಅಭ್ಯಾಸವನ್ನು ಒದಗಿಸುತ್ತವೆ
  • ಸ್ಕೆಚ್‌ನೋಟ್‌ಗಳು ದೃಶ್ಯ ಸಾರಾಂಶಗಳನ್ನು ಒದಗಿಸುತ್ತವೆ

ಸಾಮಾನ್ಯ ಸಮಸ್ಯೆಗಳ ಪರಿಹಾರ

ಜುಪೈಟರ್ ಕರ್ಣಲ್ ಸಮಸ್ಯೆಗಳು:

# ಸರಿಯಾದ ಕರ್ಣಲ್ ಸ್ಥಾಪಿತವಾಗಿದೆ ಎಂದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ
python -m ipykernel install --user --name=datascience

npm ಸ್ಥಾಪನೆ ವಿಫಲತೆಗಳು:

# npm ಕ್ಯಾಶೆ ತೆರವುಗೊಳಿಸಿ ಮತ್ತು ಮರುಪ್ರಯತ್ನಿಸಿ
npm cache clean --force
rm -rf node_modules package-lock.json
npm install

ನೋಟ್ಬುಕ್‌ಗಳಲ್ಲಿ ಆಮದು ದೋಷಗಳು:

  • ಅಗತ್ಯವಿರುವ ಎಲ್ಲಾ ಲೈಬ್ರರಿಗಳು ಸ್ಥಾಪಿತವಾಗಿವೆ ಎಂದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ
  • ಪೈಥಾನ್ ಆವೃತ್ತಿ ಹೊಂದಾಣಿಕೆ ಪರಿಶೀಲಿಸಿ (ಪೈಥಾನ್ 3.7+ ಶಿಫಾರಸು)
  • ವರ್ಚುವಲ್ ಪರಿಸರ ಸಕ್ರಿಯವಾಗಿದೆ ಎಂದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ

Docsify ಲೋಡ್ ಆಗುತ್ತಿಲ್ಲ:

  • ನೀವು ರೆಪೊಸಿಟರಿ ರೂಟ್‌ನಿಂದ ಸರ್ವ್ ಮಾಡುತ್ತಿದ್ದೀರಾ ಎಂದು ಪರಿಶೀಲಿಸಿ
  • index.html ಇದೆ ಎಂದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ
  • ಸರಿಯಾದ ನೆಟ್‌ವರ್ಕ್ ಪ್ರವೇಶ (ಪೋರ್ಟ್ 3000) ಇದೆ ಎಂದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ

ಕಾರ್ಯಕ್ಷಮತೆ ಪರಿಗಣನೆಗಳು

  • ದೊಡ್ಡ ಡೇಟಾಸೆಟ್‌ಗಳು ನೋಟ್ಬುಕ್‌ಗಳಲ್ಲಿ ಲೋಡ್ ಆಗಲು ಸಮಯ ತೆಗೆದುಕೊಳ್ಳಬಹುದು
  • ಸಂಕೀರ್ಣ ಪ್ಲಾಟ್‌ಗಳ ದೃಶ್ಯೀಕರಣ ನಿಧಾನವಾಗಬಹುದು
  • Vue.js ಡೆವ್ ಸರ್ವರ್ ತ್ವರಿತ ಪುನರಾವೃತ್ತಿಗಾಗಿ ಹಾಟ್-ರಿಲೋಡ್ ಸೌಲಭ್ಯ ನೀಡುತ್ತದೆ
  • ಉತ್ಪಾದನಾ ನಿರ್ಮಾಣಗಳು ಆಪ್ಟಿಮೈಸ್ ಮತ್ತು ಮಿನಿಫೈ ಮಾಡಲ್ಪಟ್ಟಿವೆ

ಭದ್ರತಾ ಟಿಪ್ಪಣಿಗಳು

  • ಯಾವುದೇ ಸಂವೇದನಾಶೀಲ ಡೇಟಾ ಅಥವಾ ಪ್ರಮಾಣಪತ್ರಗಳನ್ನು ಕಮಿಟ್ ಮಾಡಬಾರದು
  • ಕ್ಲೌಡ್ ಪಾಠಗಳಲ್ಲಿ ಯಾವುದೇ API ಕೀಗಳಿಗೆ ಪರಿಸರ ಚರಗಳನ್ನು ಬಳಸಿ
  • ಅಜೂರ್ ಸಂಬಂಧಿತ ಪಾಠಗಳಿಗೆ ಅಜೂರ್ ಖಾತೆ ಪ್ರಮಾಣಪತ್ರಗಳು ಅಗತ್ಯವಿರಬಹುದು
  • ಭದ್ರತಾ ಪ್ಯಾಚ್‌ಗಳಿಗೆ ಅವಲಂಬನೆಗಳನ್ನು ನವೀಕರಿಸಿ

ಅನುವಾದಗಳಿಗೆ ಕೊಡುಗೆ ನೀಡುವುದು

  • ಸ್ವಯಂಚಾಲಿತ ಅನುವಾದಗಳನ್ನು GitHub Actions ಮೂಲಕ ನಿರ್ವಹಿಸಲಾಗುತ್ತದೆ
  • ಅನುವಾದದ ನಿಖರತೆಗಾಗಿ ಕೈಯಿಂದ ತಿದ್ದುಪಡಿ ಸ್ವಾಗತ
  • ಇತ್ತೀಚಿನ ಅನುವಾದ ಫೋಲ್ಡರ್ ರಚನೆಯನ್ನು ಅನುಸರಿಸಿ
  • ಕ್ವಿಜ್ ಲಿಂಕ್‌ಗಳನ್ನು ಭಾಷಾ ಪರಿಮಾಣದೊಂದಿಗೆ ನವೀಕರಿಸಿ: ?loc=fr
  • ಸರಿಯಾಗಿ ರೆಂಡರ್ ಆಗುವಂತೆ ಅನುವಾದಿತ ಪಾಠಗಳನ್ನು ಪರೀಕ್ಷಿಸಿ

ಸಂಬಂಧಿತ ಸಂಪನ್ಮೂಲಗಳು

ಪ್ರಾಜೆಕ್ಟ್ ನಿರ್ವಹಣೆ

  • ವಿಷಯವನ್ನು ನವೀನಗೊಳಿಸಲು ನಿಯಮಿತ ನವೀಕರಣಗಳು
  • ಸಮುದಾಯ ಕೊಡುಗೆಗಳಿಗೆ ಸ್ವಾಗತ
  • ಸಮಸ್ಯೆಗಳು GitHub ನಲ್ಲಿ ಟ್ರ್ಯಾಕ್ ಮಾಡಲಾಗುತ್ತವೆ
  • ಪಿಆರ್‌ಗಳನ್ನು ಪಠ್ಯಕ್ರಮ ನಿರ್ವಹಕರು ಪರಿಶೀಲಿಸುತ್ತಾರೆ
  • ಮಾಸಿಕ ವಿಷಯ ವಿಮರ್ಶೆಗಳು ಮತ್ತು ನವೀಕರಣಗಳು

ಅಸ್ವೀಕರಣ:
ಈ ದಸ್ತಾವೇಜು AI ಅನುವಾದ ಸೇವೆ Co-op Translator ಬಳಸಿ ಅನುವಾದಿಸಲಾಗಿದೆ. ನಾವು ನಿಖರತೆಯಿಗಾಗಿ ಪ್ರಯತ್ನಿಸುತ್ತಿದ್ದರೂ, ಸ್ವಯಂಚಾಲಿತ ಅನುವಾದಗಳಲ್ಲಿ ದೋಷಗಳು ಅಥವಾ ಅಸತ್ಯತೆಗಳು ಇರಬಹುದು ಎಂದು ದಯವಿಟ್ಟು ಗಮನಿಸಿ. ಮೂಲ ಭಾಷೆಯಲ್ಲಿರುವ ಮೂಲ ದಸ್ತಾವೇಜನ್ನು ಅಧಿಕೃತ ಮೂಲವಾಗಿ ಪರಿಗಣಿಸಬೇಕು. ಮಹತ್ವದ ಮಾಹಿತಿಗಾಗಿ, ವೃತ್ತಿಪರ ಮಾನವ ಅನುವಾದವನ್ನು ಶಿಫಾರಸು ಮಾಡಲಾಗುತ್ತದೆ. ಈ ಅನುವಾದ ಬಳಕೆಯಿಂದ ಉಂಟಾಗುವ ಯಾವುದೇ ತಪ್ಪು ಅರ್ಥಮಾಡಿಕೊಳ್ಳುವಿಕೆ ಅಥವಾ ತಪ್ಪು ವಿವರಣೆಗಳಿಗೆ ನಾವು ಹೊಣೆಗಾರರಾಗುವುದಿಲ್ಲ.