Web-Dev-For-Beginners/translations/kn/AGENTS.md

AGENTS.md

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

ಇದು ಆರಂಭಿಕರಿಗೆ ವೆಬ್ ಅಭಿವೃದ್ಧಿಯ ಮೂಲತತ್ತ್ವಗಳನ್ನು ಕಲಿಸಲು শিক্ষಾ ಪಠ್ಯಕ್ರಮದ ರೆಪಾಸಿಟರಿ. ಈ ಪಠ್ಯಕ್ರಮವು Microsoft Cloud Advocates ತಂಡದಿಂದ ಅಭಿವೃದ್ಧಿಪಡಿಸಿದ ಸಂಪೂಟ 12-ವಾರಗಳ ಕೋರ್ಸ್ ಆಗಿದ್ದು, ಜಾವಸ್ಕ್ರಿಪ್ಟ್, CSS ಮತ್ತು HTML ಅನ್ನು ಒಳಗೊಂಡ 24 ಕೈಗೆ ಒಳಗಾದ ಪಾಠಗಳನ್ನು ಒಳಗೊಂಡಿದೆ.

ಪ್ರಮುಖ ಘಟಕಗಳು

• ಶಿಕ್ಷಣಾತ್ಮಕ ವಿಷಯ: ಯೋಜನೆ ಆಧಾರಿತ ಘಟಕಗಳಾಗಿ 24 ವಿನ್ಯಾಯಿತ ಪಾಠಗಳು
• ಪ್ರಾಯೋಗಿಕ ಯೋಜನೆಗಳು: ಟೆರರಿಯಂ, ಟೈಪಿಂಗ್ ಆಟ, ಬ್ರೌಸರ್ ವಿಸ್ತರಣೆ, ಸ್ಥಳದ ಆಟ, ಬ್ಯಾಂಕಿಂಗ್ ಅಪ್ಲಿಕೇಶನ್, ಕೋಡ್ ಎಡಿಟರ್ ಮತ್ತು AI ಚಾಟ್ ಸಹಾಯಕ
• ಪರಸ್ಪರ ಕ್ರಿಯಾಶೀಲ ಕ್ವಿಜ್‌ಗಳು: ಪ್ರತಿ ಒಂದು ಕ್ವಿಜ್‌ಗೆ 3 ಪ್ರಶ್ನೆಗಳ ಕಾಲ 48 ಕ್ವಿಜ್‌ಗಳು (ಪಾಠಕ್ಕೆ ಮುಂಚಿನ/ನಂತರದ ಮೌಲ್ಯಮಾಪನ)
• ಬಹುಭಾಷಾ ಬೆಂಬಲ: GitHub Actions ಮೂಲಕ 50+ ಭಾಷೆಗಳಿಗೆ ಸ್ವಯಂಚಾಲಿತ ಅನುವಾದ
• ತಂತ್ರಜ್ಞಾನಗಳು: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI ಯೋಜನೆಗಳಿಗೆ)

ಶಿಲ್ಪವಿಧಾನ

• ಪಾಠ ಆಧಾರಿತ ರಚನೆಯೊಂದಿಗೆ ಶಿಕ್ಷಣ ರೆಪಾಸಿಟರಿ
• ಪ್ರತಿ ಪಾಠದ ಫೋಲ್ಡರ್ ಗೆ README, ಕೋಡ್ ಉದಾಹರಣೆಗಳು ಮತ್ತು ಪರಿಹಾರಗಳು
• ವಿಭಿನ್ನ ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ ಸ್ವತಂತ್ರ ಯೋಜನೆಗಳು (quiz-app, ವಿವಿಧ ಪಾಠ ಯೋಜನೆಗಳು)
• GitHub Actions ಬಳಸಿ ಅನುವಾದ ವ್ಯವಸ್ಥೆ (co-op-translator)
• Docsify ಮೂಲಕ ಡಾಕ್ಯುಮೆಂಟೇಶನ್ ವಿತರಣೆ ಮತ್ತು PDF ರೂಪದಲ್ಲಿ ಲಭ್ಯವಿದೆ

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

ಈ ರೆಪಾಸಿಟರಿ ಮುಖ್ಯವಾಗಿ ಶಿಕ್ಷಣಕ್ಕಾಗಿ ವಿಷಯ ಸೇವೆಗೆ. ನಿರ್ದಿಷ್ಟ ಯೋಜನೆಗಳ ಜೊತೆಗೆ ಕೆಲಸ ಮಾಡಲು:

ಮುಖ್ಯ ರೆಪಾಸಿಟರಿ ಸೆಟಪ್

git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners

ಕ್ವಿಜ್ ಅಪ್ ಸೆಟಪ್ (Vue 3 + Vite)

cd quiz-app
npm install
npm run dev        # ಅಭಿವೃದ್ಧಿ ಸರ್ವರ್ ಪ್ರಾರಂಭಿಸಿ
npm run build      # ಉತ್ಪಾದನೆಯಿಗಾಗಿ ನಿರ್ಮಿಸಿ
npm run lint       # ESLint ನಡೆಸಿ

ಬ್ಯಾಂಕಿಂಗ್ ಯೋಜನೆ API (Node.js + Express)

cd 7-bank-project/api
npm install
npm start          # ಎಪಿಐ ಸರ್ವರ್ ಪ್ರಾರಂಭಿಸಿ
npm run lint       # ESLint ಅನ್ನು ರನ್ ಮಾಡಿ
npm run format     # prettier ಮೂಲಕ ಫಾರ್ಮ್ಯಾಟ್ ಮಾಡಿ

ಬ್ರೌಸರ್ ವಿಸ್ತರಣೆ ಯೋಜನೆಗಳು

cd 5-browser-extension/solution
npm install
# ಬ್ರೌಸರ್-ನಿರ್ದಿಷ್ಟ ವಿಸ್ತರಣೆ ಲೋಡ್‌ ಮಾಡಲು ಸೂಚನೆಗಳನ್ನು ಅನುಸರಿಸಿ

ಸ್ಥಳದ ಆಟ ಯೋಜನೆಗಳು

cd 6-space-game/solution
npm install
# ಬ್ರೌಸರ್‌ನಲ್ಲಿ index.html ತೆರೆಯಿರಿ ಅಥವಾ ಲೈವ್ ಸರ್ವರ್ ಬಳಸಿರಿ

ಚಾಟ್ ಯೋಜನೆ (Python ಬ್ಯಾಕೆಂಡ್)

cd 9-chat-project/solution/backend/python
pip install openai
# GITHUB_TOKEN ಪರಿಸರ ಚರವನ್ನು ಸೆಟ್ ಮಾಡಿ
python api.py

ಅಭಿವೃದ್ಧಿ ಕೆಲಸದ ಪ್ರವಾಹ

ವಿಷಯ ಕೊಡುಗೆದಾರರಿಗಾಗಿ

1. ರೆಪಾಸಿಟರಿಯನ್ನು ಫೋರ್ಕ್ ಮಾಡಿ ನಿಮ್ಮ GitHub ಖಾತೆಗೆ
2. ಫೋರ್ಕ್ ಅನ್ನು ಸ್ಥಳೀಯವಾಗಿ ಕ್ಲೋನ್ ಮಾಡಿ
3. ನಿಮ್ಮ ಬದಲಾವಣೆಗಳಿಗಾಗಿ ಹೊಸ ಶಾಖೆಯನ್ನು ಮಾಡಿ
4. ಪಾಠ ವಿಷಯ ಅಥವಾ ಕೋಡ್ ಉದಾಹರಣೆಗಳಲ್ಲಿ ಬದಲಾವಣೆ ಮಾಡಿ
5. ಸಂಬಂಧಿತ ಯೋಜನೆ ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ ಯಾವುದೇ ಕೋಡ್ ಬದಲಾವಣೆಗಳನ್ನು ಪರೀಕ್ಷಿಸಿ
6. ಕೊಡುಗೆ ಮಾರ್ಗಸೂಚಿಗಳಂತೆ ಪુલ್ ರಿಕ್ವೆಸ್ಟ್ ಸಲ್ಲಿಸಿ

ಕಲಿಯುವವರಿಗಾಗಿ

1. ರೆಪಾಸಿಟರಿಯನ್ನು ಫೋರ್ಕ್ ಅಥವಾ ಕ್ಲೋನ್ ಮಾಡಿ
2. ಸರಣಿಯಲ್ಲಿ ಪಾಠ ಡೈರೆಕ್ಟರಿಗಳಿಗೆ ನವಿಗೇಟ್ ಮಾಡಿ
3. ಪ್ರತಿ ಪಾಠದ README ಫೈಲ್ ಓದಿ
4. ಮುಂಚಿನ ಪಾಠದ ಕ್ವಿಜ್‌ಗಳನ್ನು https://ff-quizzes.netlify.app/web/ ನಲ್ಲಿ ಪೂರೈಸಿ
5. ಪಾಠ ಫೋಲ್ಡರ್‌ಗಳಲ್ಲಿ ಕೋಡ್ ಉದಾಹರಣೆಗಳ ಮೂಲಕ ಕೆಲಸ ಮಾಡಿ
6. ಕಾರ್ಯಗಳನ್ನು ಮತ್ತು ಸವಾಲುಗಳನ್ನು ಪೂರ್ಣಗೊಳಿಸಿ
7. ನಂತರದ ಪಾಠದ ಕ್ವಿಜ್‌ಗಳನ್ನು ತೆಗೆದುಕೊಳ್ಳಿ

ప్రత్యಕ್ಷ ಅಭಿವೃದ್ಧಿ

• ಡಾಕ್ಯುಮೆಂಟೇಶನ್: ರೂಟ್‌ನಲ್ಲಿ docsify serve ರನ್ ಮಾಡಿ (ಪೋರ್ಟ್ 3000)
• ಕ್ವಿಜ್ ಅಪ್: quiz-app ಡೈರೆಕ್ಟರಿಯಲ್ಲಿ npm run dev ರನ್ ಮಾಡಿ
• ಯೋಜನೆಗಳು: HTML ಯೋಜನೆಗಳಿಗೆ VS Code Live Server ವಿಸ್ತರಣೆ ಬಳಸಿ
• API ಯೋಜನೆಗಳು: ಸಂಬಂಧಿತ API ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ npm start ರನ್ ಮಾಡಿ

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

ಕ್ವಿಜ್ ಅಪ್ ಪರೀಕ್ಷೆ

cd quiz-app
npm run lint       # ಕೋಡ್ ಶೈಲಿ ಸಮಸ್ಯೆಗಳನ್ನು ಪರಿಶೀಲಿಸಿ
npm run build      # ನಿರ್ಮಾಣ ಯಶಸ್ವಿಯಾಗಿದೆಯೇ ಎಂದು ಪರಿಶೀಲಿಸಿ

ಬ್ಯಾಂಕ್ API ಪರೀಕ್ಷೆ

cd 7-bank-project/api
npm run lint       # ಕೋಡ್ ಶೈಲಿ ಸಮಸ್ಯೆಗಳಿಗಾಗಿ ಪರಿಶೀಲಿಸಿ
node server.js     # ಸರ್ವರ್ ಎರರ್ ಇಲ್ಲದೆ ಪ್ರಾರಂಭವಾಗುತ್ತದೆಯಾ ಎಂದು ಪರಿಶೀಲಿಸಿ

ಸಾಮಾನ್ಯ ಪರೀಕ್ಷಾ ವಿಧಾನ

• ಇದು ಸಂಪೂರ್ಣ ಸ್ವಯಂಚಾಲಿತ ಪರೀಕ್ಷೆಗಳುಳ್ಳ ಶಿಕ್ಷಣ ರೆಪಾಸಿಟರಿ ಅಲ್ಲ
• ಕೈಯಿಂದ ಪರೀಕ್ಷಿಸುವುದು ಮುಖ್ಯ:
  • ಕೋಡ್ ಉದಾಹರಣೆಗಳು ದೋಷವಿಲ್ಲದೆ ನಡೆಯುವುದು
  • ಡಾಕ್ಯುಮೆಂಟೇಶನ್‌ನ ಲಿಂಕುಗಳು ಸರಿಯಾಗಿ ಕೆಲಸ ಮಾಡುವುದು
  • ಪ್ರಾಜೆಕ್ಟ್ ನಿರ್ಮಾಣ ಯಶಸ್ವಿಯಾಗಿದೆ
  • ಉದಾಹರಣೆಗಳು ಉತ್ತಮ ಕ್ರಮಗಳು ಅನುಸರಿಸುತ್ತವೆ

ಸಲ್ಲಿಸುವ ಮೊದಲು ಪರಿಶೀಲನೆಗಳು

• package.json ಇರುವ ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ npm run lint ರನ್ ಮಾಡಿ
• ಮಾರ್ಕ್‌ಡೌನ್ ಲಿಂಕುಗಳು ಮಾನ್ಯವೇ ಎಂದು ಪರಿಶೀಲಿಸಿ
• ಕೋಡ್ ಉದಾಹರಣೆಗಳನ್ನು ಬ್ರೌಸರ್ ಅಥವಾ Node.js ನಲ್ಲಿ ಪರೀಕ್ಷಿಸಿ
• ಅನುವಾದಗಳು ಸರಿಯಾದ ರಚನೆ ಕಾಪಾಡುತ್ತವೆಂದು ಪರಿಶೀಲಿಸಿ

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

ಜಾವಸ್ಕ್ರಿಪ್ಟ್

• ಆಧುನಿಕ ES6+ ಸಂರಚನೆಯನ್ನು ಬಳಸಿ
• ಪ್ರಾಜೆಕ್ಟುಗಳಲ್ಲಿ ನೀಡಲಾದ ಮಾನಕ ESLint ನಿಘಂಟುಗಳನ್ನು ಅನುಸರಿಸಿ
• ಶಿಕ್ಷಣ ಸ್ಪಷ್ಟತೆಗೆ ಅರ್ಥಪೂರ್ಣ ವ್ಯತ್ಯಾಸಿಕೆ ಮತ್ತು ಫಂಕ್ಷನ್ ಹೆಸರುಗಳನ್ನು ಬಳಸಿ
• ಕಲಿಯುವವರಿಗೆ ಕಲಿಕೆಗಾಗಿ ಕಾಮೆಂಟ್‌ಗಳು ಸೇರಿಸಿ
• ಹೊಂದಿಗೊಳಿಸಿದ Prettier ಬಳಸಿ ಸ್ವರೂಪಣೆಯಾಗಿ ಫಾರ್ಮ್ಯಾಟ್ ಮಾಡಿ

HTML/CSS

• ಅರ್ಥಪೂರ್ಣ HTML5 ಅಂಶಗಳು
• ಪ್ರತಿಕ್ರಿಯಾಶೀಲ ವಿನ್ಯಾಸ ತತ್ವಗಳು
• ಸ್ಪಷ್ಟ ಕ್ಲಾಸ್ ಹೆಸರು ನಿಯಮಗಳು
• CSS ತಂತ್ರಗಳನ್ನು ಕಲಿಯುವವರಿಗೆ ವಿವರಿಸುವ ಕಾಮೆಂಟ್‌ಗಳು

ಪೈಥಾನ್

• PEP 8 ಶೈಲಿ ಮಾರ್ಗಸೂಚಿಗಳು
• ಸ್ವಚ್ಚ, ಶಿಕ್ಷಣಾತ್ಮಕ ಕೋಡ್ ಉದಾಹರಣೆಗಳು
• ಕಲಿಕೆಯ ಸರಿಗೆ ಉಚಿತ ಟೈಪಿಂಗ್ ಸೂಚನೆಗಳು

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

• ಸ್ಪಷ್ಟ ಶೀರ್ಷಿಕೆ ಹಿರarchicalತೆ
• ಭಾಷಾ ಪಾರದರ್ಶಕತೆ ಸಹಿತ ಕೋಡ್ ಬ್ಲಾಕ್‌ಗಳು
• ಹೆಚ್ಚುವರಿ ಸಂಪನ್ಮೂಲಗಳಿಗೆ ಲಿಂಕುಗಳು
• images/ ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ ಸ್ಕ್ರೀನ್‌ಶಾಟ್ ಮತ್ತು ಚಿತ್ರಗಳು
• ಪ್ರಾಪ್ಯತೆಗಾಗಿ ಚಿತ್ರಗಳಿಗೆ_ALT_ ಪಠ್ಯ

ಫೈಲ್ ಸಂಘಟನೆ

• ಪಾಠಗಳು ಕ್ರಮಕ್ರಮವಾಗಿ ಸಂಖ್ಯೆಮಾಡಲ್ಪಟ್ಟಿವೆ (1-getting-started-lessons, 2-js-basics, ಇತ್ಯಾದಿ)
• ಪ್ರತಿ ಯೋಜನೆಯಲ್ಲಿ solution/ ಮತ್ತು ಬಹುಮಾನವಾಗಿ start/ ಅಥವಾ your-work/ ಡೈರೆಕ್ಟರಿಗಳು ಇವೆ
• ಚಿತ್ರಗಳನ್ನು ಪಾಠ-ನಿರ್ದಿಷ್ಟ images/ ಫೋಲ್ಡರ್ಗಳು ಇಟ್ಟುಕೊಂಡಿವೆ
• ಅನುವಾದಗಳನ್ನು translations/{language-code}/ ರಚನೆಯಲ್ಲಿ ಇಡಲಾಗುತ್ತದೆ

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

ಕ್ವಿಜ್ ಅಪ್ ನಿಯೋಜನೆ (Azure Static Web Apps)

ಕ್ವಿಜ್-ಅಪ್ Azure Static Web Apps ನಿಯೋಜನೆಗೆ ವ್ಯವಸ್ಥಾಪಿತವಾಗಿದೆ:

cd quiz-app
npm run build      # dist/ ಫೋಲ್ಡರ್ ರಚಿಸುತ್ತದೆ
# ಮುಖ್ಯ ಶಾಖೆಗೆ ಪುಷ್ ಮಾಡಿದಾಗ GitHub Actions ಕೆಲಸಪ್ರಕ್ರಿಯೆಯ ಮೂಲಕ ನಿಯೋಜಿಸುತ್ತದೆ

Azure Static Web Apps ಸಂರಚನೆ:

• ಆ್ಯಪ್ ಸ್ಥಳ: /quiz-app
• ನಿರ್ಗಮನ ಸ್ಥಳ: dist
• ಕಾರ್ಯಪ್ರವಾಹ: .github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml

ಡಾಕ್ಯುಮೆಂಟೇಶನ್ PDF ತಯಾರಿಕೆ

npm install                    # docsify-to-pdfನ್ನು ಸ್ಥಾಪಿಸಿ
npm run convert               # ಡಾಕ್ಗಳಿಂದ PDF ರಚಿಸಿ

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

npm install -g docsify-cli    # Docsify ಅನ್ನು ಗ್ಲೋಬಲ್ ಆಗಿ ಇನ್‌ಸ್ಟಾಲ್ ಮಾಡಿ
docsify serve                 # localhost:3000 ನಲ್ಲಿ ಸರ್ವ್ ಮಾಡಿ

ಪ್ರಾಜೆಕ್ಟ್-ಸ್ಪಷ್ಟ ನಿರ್ಮಾಣಗಳು

ಪ್ರತಿ ಪ್ರಾಜೆಕ್ಟ್ ಡೈರೆಕ್ಟರಿಗೆ ತನ್ನದೇನ್ ನಿರ್ಮಾಣ ಪ್ರಕ್ರಿಯೆಯಿರಬಹುದು:

• Vue ಪ್ರಾಜೆಕ್ಟುಗಳು: npm run build ರನ್ ಮಾಡಿ ಉತ್ಪಾದನಾ ಬಂಡಲ್‌ಗಳನ್ನು ಸೃಷ್ಟಿಸಿ
• ಸ್ಥಿರ ಪ್ರಾಜೆಕ್ಟುಗಳು: ಯಾವುದೇ ನಿರ್ಮಾಣ ಹಂತವಿಲ್ಲ, ಫೈಲ್‌ಗಳನ್ನು ನೇರವಾಗಿ ಸೇವ್ ಮಾಡುತ್ತದೆ

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

ಶೀರ್ಷಿಕೆ ಮಾದರಿ

ಬದಲಾವಣೆ ಪ್ರದೇಶದ ಸ್ಪಷ್ಟ, ವಿವರಣಾತ್ಮಕ ಶೀರ್ಷಿಕೆಗಳನ್ನು ಬಳಸಿ:

• [Quiz-app] ಪಾಠ X ಗೆ ಹೊಸ ಕ್ವಿಜ್ ಸೇರಿಸಲಾಗಿದೆ
• [Lesson-3] ಟೆರರಿಯಮ್ ಯೋಜನೆಯಲ್ಲಿ ಟೈಪೋ ಸರಿಪಡಿಸಲಾಗಿದೆ
• [Translation] ಪಾಠ 5ಕ್ಕೆ ಸ್ಪ್ಯಾನಿಷ್ ಅನುವಾದವನ್ನು ಸೇರಿಸಲಾಗಿದೆ
• [Docs] ಸೆಟಪ್ ಸೂಚನೆಗಳನ್ನು ನವೀಕರಿಸಲಾಗಿದೆ

ಅಗತ್ಯ ಪರಿಶೀಲನೆಗಳು

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

1. ಕೋಡ್ ಗುಣಮಟ್ಟ:

   • ಸಂಬಂಧಿತ ಪ್ರಾಜೆಕ್ಟ್ ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿ npm run lint ರನ್ ಮಾಡಿ
   • ಎಲ್ಲಾ ಲಿಂಟ್ ದೋಷಗಳ ಮತ್ತು ಎಚ್ಚರಿಕೆಗಳನ್ನು ಸರಿಪಡಿಸಿ

2. ನಿರ್ಮಾಣ ಪರಿಶೀಲನೆ:

   • ಅನ್ವಯವಾಗುವಲ್ಲಿ npm run build ರನ್ ಮಾಡಿ
   • ಯಾವುದೇ ನಿರ್ಮಾಣ ದೋಷಗಳಿಲ್ಲವೆಂದು ಖಚಿತಪಡಿಸಿ

3. ಲಿಂಕ್ ಪರಿಶೀಲನೆ:

   • ಎಲ್ಲಾ ಮಾರ್ಕ್‌ಡೌನ್ ಲಿಂಕುಗಳನ್ನು ಪರೀಕ್ಷಿಸಿ
   • ಚಿತ್ರ ಉಲ್ಲೇಖಗಳು ಕಾರ್ಯನಿರ್ವಹಿಸುತ್ತವೆಯೇ ಎಂದು ಖಚಿತಪಡಿಸಿ

4. ವಿಷಯ ವಿಮರ್ಶೆ:

   • ವಚನಮಾಲಿಕೆಯಲ್ಲಿ ಸೂಕ್ತತೆ ಪರಿಶೀಲಿಸಿ
   • ಕೋಡ್ ಉದಾಹರಣೆಗಳು ಸರಿಯಾಗಿದೆ ಮತ್ತು ಶೈಕ್ಷಣಿಕವಾಗಿವೆ ಎಂದು ಖಚಿತಪಡಿಸಿ
   • ಅನುವಾದಗಳು ಮೂಲ ಅರ್ಥವನ್ನು ಕಾಪಾಡಿಕೊಳ್ಳುತ್ತವೆ ಎಂದು ಪರಿಶೀಲಿಸಿ

ಕೊಡುಗೆ ಅಗತ್ಯತೆಗಳು

• Microsoft CLA ಗೆ ಸಮ್ಮತಿ ನೀಡಿ (ಮೊದಲ PR ಮೇಲೆ ಸ್ವಯಂಚಾಲಿತ ಪರಿಶೀಲನೆ)
• Microsoft Open Source Code of Conduct ಅನುಸರಿಸಿ
• ವಿಶದ ಮಾರ್ಗಸೂಚಿಗಾಗಿ CONTRIBUTING.md ನೋಡಿ
• ಯೋಜಿತ ಸಮಸ್ಯೆಗಳ ಸಂಖ್ಯೆಯನ್ನು PR ವಿವರಣೆಯಲ್ಲಿ ಉಲ್ಲೇಖಿಸಿ

ವಿಮರ್ಶಾ ಪ್ರಕ್ರಿಯೆ

• PRಗಳನ್ನು ನಿರ್ವಹಕರು ಮತ್ತು ಸಮುದಾಯ ವಿಮರ್ಶೆ ಮಾಡುತ್ತಾರೆ
• ಶಿಕ್ಷಣ ಸ್ಪಷ್ಟತೆ ಅವರನ್ನು ಆದ್ಯತೆ
• ಕೋಡ್ ಉದಾಹರಣೆಗಳು ಇತ್ತೀಚಿನ ಉತ್ತಮ ಕ್ರಮಗಳು ಅನುಸರಿಸಬೇಕು
• ಅನುವಾದಗಳನ್ನು ಶುದ್ಧತೆ ಮತ್ತು ಸಾಂಸ್ಕೃತಿಕ ಅನುಕೂಲತೆಗಾಗಿ ಪರಿಗಣಿಸಲಾಗುತ್ತದೆ

ಅನುವಾದ ವ್ಯವಸ್ಥೆ

ಸ್ವಯಂಚಾಲಿತ ಅನುವಾದ

• GitHub Actions ಮತ್ತು co-op-translator workflow ಬಳಸಿ
• 50+ ಭಾಷೆಗಳಿಗೆ ಸ್ವಯಂಚಾಲಿತ ಅನುವಾದ
• ಮೂಲ ಫೈಲ್‌ಗಳು ಮುಖ್ಯ ಡೈರೆಕ್ಟರಿಗಳಲ್ಲಿವೆ
• ಅನುವಾದಿತ ಫೈಲ್‌ಗಳು translations/{language-code}/ ರಚನೆಯಲ್ಲಿ ಇವೆ

ಕೈಯಲ್ಲಿ ಅನುವಾದ ಸುಧಾರಣೆ ಸೇರಿಸುವುದು

1. translations/{language-code}/ ನಲ್ಲಿ ಫೈಲ್ ಹುಡುಕಿ
2. ರಚನೆಯನ್ನು ಉಳಿಸಿಕೊಂಡು ಸುಧಾರಣೆ ಮಾಡಲು
3. ಕೋಡ್ ಉದಾಹರಣೆಗಳು ಕಾರ್ಯನಿರ್ವಹಿಸುತ್ತವೆ ಎಂದು ಖಚಿತಪಡಿಸಲು
4. ಸ್ಥಳೀಯ ಕ್ವಿಜ್ ವಿಷಯವನ್ನು ಪರೀಕ್ಷಿಸಿ

ಅನುವಾದ ಮೆಟಾಡೇಟಾ

ಅನುವಾದಿತ ಫೈಲ್‌ಗಳ ಮುಂಭಾಗದಲ್ಲಿ ಮೆಟಾಡೇಟಾ ಅಂಶಗಳನ್ನು ಒಳಗೊಂಡಿದೆ:

<!--
CO_OP_TRANSLATOR_METADATA:
{
  "original_hash": "...",
  "translation_date": "...",
  "source_file": "...",
  "language_code": "..."
}
-->

ದೋಷಶೋಧನೆ ಮತ್ತು ಸಮಸ್ಯೆ ಪರಿಹಾರ

ಸಾಮಾನ್ಯ ಸಮಸ್ಯೆಗಳು

ಕ್ವಿಜ್ ಅಪ್ ಆರಂಭಿಸಲು ವಿಫಲವಾಗಿದೆ:

• Node.js ಆವೃತ್ತಿ (v14+ ಶಿಫಾರಸು) ಪರಿಶೀಲಿಸಿ
• node_modules ಮತ್ತು package-lock.json ಅಳಿಸಿ, ಮತ್ತೆ npm install ರನ್ ಮಾಡಿ
• ಪೋರ್ಟ್ ಸಂಘರ್ಷಗಳನ್ನು ಪರಿಶೀಲಿಸಿ (ಪೂರ್ವನಿಯೋಜಿತ: Vite ಪೋರ್ಟ್ 5173 ಬಳಸುತ್ತದೆ)

API ಸರ್ವರ್ ಆರಂಭಿಸೋದಿಲ್ಲ:

• Node.js ಆವೃತ್ತಿ ಕಡಿಮೆ ಆಗಿರಬಾರದು (node >=10)
• ಪೋರ್ಟ್ ಬಳಕೆಯಲ್ಲದಿರುವುದನ್ನು ಪರಿಶೀಲಿಸಿ
• ಎಲ್ಲಾ ಅವಲಂಬನೆಗಳು ಇನ್‌ಸ್ಟಾಲ್ ಆಗಿವೆ ಎಂದು ಖಚಿತಪಡಿಸಿ npm install ಮೂಲಕ

ಬ್ರೌಸರ್ ವಿಸ್ತರಣೆ ಲೋಡ್ ಆಗೋದಿಲ್ಲ:

• manifest.json ಸರಿಯಾದ ಸ್ವರೂಪದಲ್ಲಿದೆಯೇ ಎಂದು ಪರಿಶೀಲಿಸಿ
• ಬ್ರೌಸರ್ ಕಾಂಸೋಲ್ ದೋಷಗಳು ಹೇಗಿವೆ ಎಂಬುದನ್ನು ಪರಿಶೀಲಿಸಿ
• ಬ್ರೌಸರ್-ನಿರ್ದಿಷ್ಟ ವಿಸ್ತರಣೆ ಸ್ಥಾಪನೆ ಸೂಚನೆಗಳು ಅನುಸರಿಸಿ

Python ಚಾಟ್ ಯೋಜನೆ ಸಮಸ್ಯೆಗಳು:

• OpenAI ಪ್ಯಾಕೇಜ್ ಇನ್‌ಸ್ಟಾಲ್ ಮಾಡಿ: pip install openai
• GITHUB_TOKEN ಪರಿಸರ ಚರ ಇನ್‌ಸ್ಟಾಲ್ ಆಗಿದೆ ಎಂದು ಖಚಿತಪಡಿಸಿ
• GitHub Models ಪ್ರವೇಶ ಪರವಾನಿಗೆಗಳನ್ನು ಪರಿಶೀಲಿಸಿ

Docsify ಡಾಕ್ಯುಮೆಂಟೇಶನ್ ನೀಡಲಾಗುತ್ತಿಲ್ಲ:

• globallu docsify-cli ಇನ್‌ಸ್ಟಾಲ್ ಮಾಡಿ: npm install -g docsify-cli
• ರೆಪಾಸಿಟರಿಯ ರೂಟ್ ಡೈರೆಕ್ಟರಿಯಿಂದ ರನ್ ಮಾಡಿ
• docs/_sidebar.md ಇದ್ದು ಇರುವುದನ್ನು ಪರಿಶೀಲಿಸಿ

ಅಭಿವೃದ್ಧಿ ಪರಿಸರ ಸಲಹೆಗಳು

• HTML ಯೋಜನೆಗಳಿಗೆ VS Code Live Server ವಿಸ್ತರಣೆ ಬಳಸಿರಿ
• ಓರ್ವ ESLint ಮತ್ತು Prettier ವಿಸ್ತರಣೆಗಳನ್ನು ಸ್ಥಾಪಿಸಿ ನಿರಂತರ ಸ್ವರೂಪಣೆಗೆ
• ಜಾವಾ ಸ್ಕ್ರಿಪ್ಟ್ ದೋಷ ಶೋಧಿಸಲು ಬ್ರೌಸರ್ ಡೆವ್ ಟೂಲ್ಗಳು ಬಳಸಿರಿ
• Vue ಯೋಜನೆಗಳಿಗೆ Vue DevTools ಬ್ರೌಸರ್ ವಿಸ್ತರಣೆ ಸ್ಥಾಪಿಸಿ

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

• ಅನೇಕ ಅನುವಾದಿತ ಫೈಲ್‌ಗಳು (50+ ಭಾಷೆಗಳು) ಇರುವುದು ಸಂಪೂರ್ಣ ಕ್ಲೋನ್‌ಗಳ ಪ್ರಮಾಣವನ್ನು ಹೆಚ್ಚಿಸುತ್ತದೆ
• ವಿಷಯದ ಮೇಲೆ ಮಾತ್ರ ಕೆಲಸ ಮಾಡುವಾಗ git clone --depth 1 ಮೂಲಕ ತಳಮಟ್ಟದ ಕ್ಲೋನ್ ಉಪಯೋಗಿಸಿ
• ಇಂಗ್ಲಿಷ್ ವಿಷಯಕ್ಕೆ ಸಂಬಂಧಿಸಿದ ಹುಡುಕಾಟಗಳಲ್ಲಿ ಅನುವಾದಗಳನ್ನು ഒഴിവುಮಾಡಿ
• ನಿರ್ಮಾಣ ಪ್ರಕ್ರಿಯೆಗಳು ಮೊದಲ ರನ್‌ನಲ್ಲಿ ನಿಧಾನವಾಗಬಹುದು (npm install, Vite ನಿರ್ಮಾಣ)

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

ಪರಿಸರ ಚರ

• API ಕೀಲಿಗಳನ್ನು ರೆಪಾಸಿಟರಿಯಲ್ಲಿ ಬಿಗ್‌ಪಡಿಸಬಾರದು
• .env ಫೈಲ್‌ಗಳನ್ನು ಬಳಸಿ (ಹಾಗೂ .gitignore ಒಳಗೊಂಡಿದೆ)
• ಅಗತ್ಯವಿರುವ ಪರಿಸರ ಚರಗಳನ್ನು ಪ್ರಾಜೆಕ್ಟ್ READMEಗಳಲ್ಲಿ ದಾಖಲೆ ಮಾಡಿ

Python ಯೋಜನೆಗಳು

• ವರ್ಚುವಲ್ ಪರಿಸರ ಬಳಸಿ: python -m venv venv
• ಅವಲಂಬನೆಗಳನ್ನು ನವೀಕರಿಸಿ
• GitHub ಟೋಕನ್ಗಳು ಕನಿಷ್ಟ ಅಗತ್ಯ ಪರವಾನಿಗೆಗಳಿರಲಿ

GitHub Models ಪ್ರವೇಶ

• GitHub Models ಗಾಗಿ Personal Access Tokens (PAT) ಅಗತ್ಯ
• ಟೋಕನ್‌ಗಳನ್ನು ಪರಿಸರ ಚರಗಳಾಗಿ ಸಂರಕ್ಷಿಸಿ
• ಟೋಕನ್‌ಗಳು ಅಥವಾ ಪ್ರಮಾಣಪತ್ರಗಳನ್ನು ಕಡ್ಡಾಯವಾಗಿ ಕಮಿಟ್ ಮಾಡಬಾರದು

ಹೆಚ್ಚುವರಿ ಟಿಪ್ಪಣಿಗಳು

ಗುರಿ ಪ್ರೇಕ್ಷಕ

• ವೆಬ್ ಅಭಿವೃದ್ಧಿಯ ಸಂಪೂರ್ಣ ಆರಂಭಿಕರು
• ವಿದ್ಯಾರ್ಥಿಗಳು ಮತ್ತು ಸ್ವಯಂ ಅಧ್ಯಯನದವರು
• ತರಗತಿಗಳಲ್ಲಿ ಪಠ್ಯಕ್ರಮ ಬಳಸುವ ಶಿಕ್ಷಕರು
• ಪ್ರವೇಶ್ಯತೆ ಮತ್ತು ಹಗ್ಗದ ಕೌಶಲ್ಯ ನಿರ್ಮಾಣಕ್ಕಾಗಿ ವಿನ್ಯಾಸಗೊಳಿಸಲಾಗಿದೆ

ಶೈಕ್ಷಣಿಕ ತತ್ತ್ವಶಾಸ್ತ್ರ

• ಯೋಜನೆ ಆಧಾರಿತ ವಿದ್ಯಾರ್ಥಿ
• ನಿಯಮಿತ ಜ್ಞಾನದ ಪರಿಶೀಲನೆಗಳು (ಕ್ವಿಜ್‌ಗಳು)
• ಕೈಗೆ ಹಾಕುವ ಕೋಡಿಂಗ್ ಅಭ್ಯಾಸಗಳು
• ನೈಜ ಜಗತ್ತಿನ ಅನ್ವಯಿಕೆ ಉದಾಹರಣೆಗಳು
• ಫ್ರೇಮ್‌ವರ್ಕ್ ಗಳು ಮುಂದೆ ಮೂಲಭೂತ ತತ್ತ್ವಗಳ ಮೇಲೆ ಹೆಚ್ಚು ಗಮನ

ರೆಪಾಸಿಟರಿ ನಿರ್ವಹಣೆ

• ಚಟುವಟಿಕೆಯ ಸಮಾಜ ಕಲಿಯುವ, ಕೊಡುಗೆದಾರರೊಂದಿಗೆ
• ಅವಲಂಬನೆಗಳು ಮತ್ತು ವಿಷಯದ ನಿಯಮಿತ ನವೀಕರಣ
• ಸಮಸ್ಯೆಗಳು ಮತ್ತು ಚರ್ಚೆಗಳ ಮೇಲ್ವಿಚಾರಣೆಯ ಜೊತೆಗೆ
• GitHub Actions ಮುಖಾಂತರ ಸ್ವಯಂಚಾಲಿತ ಅನುವಾದ ನವೀಕರಣಗಳು

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

• Microsoft Learn modules
• Student Hub resources
• GitHub Copilot ಕಲಿಯುವವರಿಗಾಗಿ ಶಿಫಾರಸು ಮಾಡಲಾಗಿದೆ
• ಹೆಚ್ಚುವರಿ ಕೋರ್ಸುಗಳು: ಜನರೇಟಿವ್ AI, ಡೇಟಾ ವಿಜ್ಞಾನ, ML, IoT ಪಠ್ಯಕ್ರಮಗಳು ಲಭ್ಯ

ನಿರ್ದಿಷ್ಟ ಯೋಜನೆಗಳೊಂದಿಗೆ ಕೆಲಸ

ವಿವರವಾದ ಸೂಚನೆಗಳಿಗೆ ಪ್ರತಿ ಯೋಜನೆ README ಫೈಲ್‌ಗಳನ್ನು ನೋಡಿ:

• quiz-app/README.md - Vue 3 ಕ್ವಿಜ್ ಅಪ್ಲಿಕೇಶನ್
• 7-bank-project/README.md - ದೃಢೀಕರಣದೊಂದಿಗೆ ಬ್ಯಾಂಕಿಂಗ್ ಅಪ್ಲಿಕೇಶನ್
• 5-browser-extension/README.md - ಬ್ರೌಸರ್ ವಿಸ್ತರಣೆ ಅಭಿವೃದ್ಧಿ
• 6-space-game/README.md - ಕ್ಯಾನ್ವಾಸ್ ಆಧಾರಿತ ಆಟ ಅಭಿವೃದ್ಧಿ
• 9-chat-project/README.md - AI ಚಾಟ್ ಸಹಾಯಕ ಯೋಜನೆ

ಮನುಹಳೆ ರೆಪೊ ರಚನೆ

ಸಾಂಪ್ರದಾಯಿಕ ಮನುಹಳೆ ರೆಪೊ ಅಲ್ಲದಿದ್ದರೂ, ಈ ರೆಪೊ ಬಹು ಸ್ವತಂತ್ರ ಯೋಜನೆಗಳನ್ನು ಹೊಂದಿದೆ:

• ಪ್ರತಿ ಪಾಠವು ಸ್ವತಂತ್ರವಾಗಿದೆ
• ಯೋಜನೆಗಳು ಅವಲಂಬನೆಗಳನ್ನು ಹಂಚಿಕೊಳ್ಳುತ್ತಿಲ್ಲ
• ಪ್ರತಿ ಯೋಜನೆಯಲ್ಲಿ ಪ್ರತ್ಯೇಕವಾಗಿ ಕೆಲಸಮಾಡಿ ಇತರೆಗಳ ಮೇಲೆ ಪ್ರಭಾವ ಬಡಿಸದೆ
• ಸಂಪೂರ್ಣ ಪಠ್ಯಕ್ರಮದ ಅನುಭವಕ್ಕಾಗಿ ಪೂರ್ಣ ರೆಪೊ ಕ್ಲೋನ್ ಮಾಡಿ

---

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