diff --git a/translations/et/.co-op-translator.json b/translations/et/.co-op-translator.json index ade96139d..9dd3ce251 100644 --- a/translations/et/.co-op-translator.json +++ b/translations/et/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2026-02-06T10:40:12+00:00", + "translation_date": "2026-02-06T12:11:30+00:00", "source_file": "AGENTS.md", "language_code": "et" }, diff --git a/translations/et/AGENTS.md b/translations/et/AGENTS.md index 6b090f21b..253e67d45 100644 --- a/translations/et/AGENTS.md +++ b/translations/et/AGENTS.md @@ -2,42 +2,42 @@ ## Projekti ülevaade -See on hariduslik õppekava hoidla veebiarenduse põhialuste õpetamiseks algajatele. Õppekava on põhjalik 12-nädalane kursus, mille on välja töötanud Microsoft Cloud Advocates, hõlmates 24 praktilist õppetundi JavaScripti, CSSi ja HTMLi kohta. +See on hariduslik õppekava hoidla veebiarenduse fundamentide õpetamiseks algajatele. Õppekava on põhjalik 12-nädalane kursus, mille on koostanud Microsoft Cloud Advocates, sisaldades 24 praktilist õppetundi, mis käsitlevad JavaScripti, CSS-i ja HTML-i. -### Põhikomponendid +### Peamised komponendid -- **Hariduslik sisu**: 24 struktureeritud õppetundi, mis on organiseeritud projektipõhistesse moodulitesse -- **Praktilised projektid**: Terrarium, tippimise mäng, brauserilaiendus, kosmose mäng, pangarakendus, koodiredaktor ja AI juturobot -- **Interaktiivsed viktoriinid**: 48 viktoriini, igaühes 3 küsimust (enne/pärast õppetundi hindamine) -- **Mitmekeelne tugi**: Automaatne tõlkimine 50+ keelde GitHub Actionsi abil +- **Hariduslik sisu**: 24 struktureeritud õppetundi, mis on korraldatud projektipõhistesse moodulitesse +- **Praktilised projektid**: Terrarium, Tippimismäng, Brauserilaiendus, Kosmosemäng, Pangaäpp, Koodi redaktor ja AI juturobot +- **Interaktiivsed viktoriinid**: 48 viktoriini, igas 3 küsimust (enne/pärast tundi hindamine) +- **Mitmekeelne tugi**: Automaatne tõlkimine enam kui 50 keelde GitHub Actions abil - **Tehnoloogiad**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI projektide jaoks) ### Arhitektuur -- Hariduslik hoidla õppepõhise struktuuriga -- Iga õppetunni kaust sisaldab README-d, koodinäiteid ja lahendusi -- Iseteenindusprojektid eraldi kataloogides (quiz-app, erinevad õppetunniprojektid) -- Tõlkesüsteem kasutades GitHub Actionsi (co-op-translator) -- Dokumentatsioon edastatakse Docsify abil ja on saadaval PDF formaadis +- Hariduslik hoidla õppetundidel põhineva struktuuriga +- Igas õppetundi kaustas on README, koodinäited ja lahendused +- Isetegutsevad projektid eraldi kaustades (quiz-app, erinevad õppetundide projektid) +- Tõlkesüsteem kasutades GitHub Actions (co-op-translator) +- Dokumentatsioon serveeritakse Docsify abil ja on saadaval PDF-ina -## Paigalduskäsud +## Paigaldus käsud See hoidla on peamiselt mõeldud haridusliku sisu tarbimiseks. Spetsiifiliste projektidega töötamiseks: -### Peahoidla seadistamine +### Peamise hoidla seadistamine ```bash git clone https://github.com/microsoft/Web-Dev-For-Beginners.git cd Web-Dev-For-Beginners ``` -### Viktoriini rakenduse seadistamine (Vue 3 + Vite) +### Viktoriini äpi seadistamine (Vue 3 + Vite) ```bash cd quiz-app npm install npm run dev # Käivita arendusserver -npm run build # Ehita tootmiseks +npm run build # Loo tootmiseks npm run lint # Käivita ESLint ``` @@ -59,7 +59,7 @@ npm install # Järgige brauserispetsiifilisi laienduste laadimise juhiseid ``` -### Kosmose mängu projektid +### Kosmosemängu projektid ```bash cd 6-space-game/solution @@ -67,130 +67,130 @@ npm install # Ava index.html brauseris või kasuta Live Serverit ``` -### Juturoboti projekt (Python backend) +### Jutu projekti (Python Backend) ```bash cd 9-chat-project/solution/backend/python pip install openai -# Määra keskkonnamuutuja GITHUB_TOKEN +# Sea GITHUB_TOKEN keskkonnamuutuja python api.py ``` -## Arendustöövoog +## Arendusvoog -### Sisu panustajatele +### Sisukontribuutoritele -1. **Põlvitage hoidla** oma GitHubi kontole -2. **Klooni oma põlvvärk lokaalselt** +1. **Forki hoidla** oma GitHub kontole +2. **Klooni oma fork** lokaalselt 3. **Loo uus haru** oma muudatuste jaoks -4. Muutke õppetunni sisu või koodinäiteid -5. Testige koodimuudatusi vastavates projekti kataloogides -6. Esitage pull requeste vastavalt panustamise juhistele +4. Tee muudatusi õppetundide sisus või koodinäidetes +5. Testi koodimuudatusi asjakohastes projektikaustades +6. Esita pull requesteid vastavalt panustamise juhistele ### Õppijatele -1. Põlvitage või klooni hoidla -2. Liikuge järjestikku õppetundide kataloogidesse -3. Loe iga õppetunni README faile -4. Täitke enne õppetundi viktoriinid aadressil https://ff-quizzes.netlify.app/web/ -5. Töötage läbi koodinäited õppetunni kaustades -6. Täitke ülesanded ja väljakutsed -7. Tehke pärast õppetundi viktoriinid +1. Forki või klooni hoidla +2. Liigu õppetundide kaustades järjekorras +3. Loe iga tunni README faile +4. Tee enne tundi viktoriinid aadressil https://ff-quizzes.netlify.app/web/ +5. Pronksivõõra koodinäited õppetundide kaustades +6. Tee ülesanded ja väljakutsed +7. Võta pärast tundi viktoriinid -### Reaalajas arendamine +### Otsene arendus -- **Dokumentatsioon**: Käivitage `docsify serve` põhikaustas (port 3000) -- **Viktoriini rakendus**: Käivitage `npm run dev` quiz-app kataloogis -- **Projektid**: Kasutage VS Code Live Serveri laiendust HTML projektide jaoks -- **API projektid**: Käivitage `npm start` vastavates API kataloogides +- **Dokumentatsioon**: käivita juurkaustas `docsify serve` (port 3000) +- **Viktoriini äpp**: käivita `npm run dev` quiz-app kaustas +- **Projektid**: kasuta VS Code Live Serveri laiendust HTML projektide jaoks +- **API projektid**: käivita `npm start` vastavates API kaustades ## Testimise juhised -### Viktoriini rakenduse testimine +### Viktoriini äpi testimine ```bash cd quiz-app -npm run lint # Kontrolli koodistiili probleeme -npm run build # Kontrolli, kas koostamine õnnestub +npm run lint # Kontrolli koodi stiili probleeme +npm run build # Kontrolli, kas ehitus õnnestub ``` ### Panga API testimine ```bash cd 7-bank-project/api -npm run lint # Kontrolli koodistiili probleemide osas -node server.js # Kontrolli, kas server käivitub ilma vigadeta +npm run lint # Kontrolli koodistiili probleeme +node server.js # Kontrolli, et server käivitub ilma vigadeta ``` -### Üldine testimislähenemine +### Üldine testimise lähenemine -- See on hariduslik hoidla ilma põhjalike automaatsete testideta -- Manuaalne testimine keskendub: - - Koodinäited töötavad ilma vigadeta - - Dokumentatsiooni lingid toimivad õigesti - - Projektide ehitused õnnestuvad - - Näited järgivad parimaid praktikaid +- See on hariduslik hoidla ilma täielike automatiseeritud testideta +- Käsitsi testimine keskendub: + - Koodinäidete käivitumine vigadeta + - Dokumentatsiooni linkide toimimine + - Projektide edukas ehitamine + - Näidete vastavus parimatele tavadele ### Enne esitamist tehtavad kontrollid -- Käivitage `npm run lint` kaustades, kus on package.json -- Kontrollige, et markdowni lingid on kehtivad -- Testige koodinäiteid brauseris või Node.js keskkonnas -- Kontrollige, et tõlked säilitavad korrektse struktuuri +- Käivita `npm run lint` kaustades, kus on package.json +- Kontrolli markdown linkide kehtivust +- Testi koodinäiteid brauseris või Node.js-is +- Veendu, et tõlked säilitavad õige struktuuri -## Koodi stiili juhised +## Koodistiili juhised ### JavaScript -- Kasutage kaasaegset ES6+ süntaksit -- Järgige projektides olevaid standardseid ESLinti konfiguratsioone -- Kasutage tähenduslikke muutujate ja funktsioonide nimesid haridusliku selguse tagamiseks -- Lisage kommentaare, mis selgitavad kontseptsioone õppijatele -- Vormindage Prettieriga, kui see on seadistatud +- Kasuta kaasaegset ES6+ süntaksit +- Järgi ESLinti standardseid konfigureeringuid projektides +- Kasuta tähenduslikke muutujate ja funktsioonide nimesid hariduse selguse huvides +- Lisa kommentaare kontseptsioonide selgitamiseks õppijatele +- Formatteeri Prettieriga, kus seadistatud ### HTML/CSS - Semantiline HTML5 elementide kasutamine -- Reageerivad disainipõhimõtted -- Selged klassi nimetamise konventsioonid -- Kommentaarid, mis selgitavad CSS tehnikat õppijatele +- Responsive disaini põhimõtted +- Selged klassinimed +- Kommentaarid CSS tehnikate selgitamiseks õppijatele ### Python -- PEP 8 stiiliajuhised +- PEP 8 stiili juhised - Selged, hariduslikud koodinäited -- Tüüpi vihjed seal, kus need aitavad õppimist +- Tüübi vihjed, kui need aitavad õppimist ### Markdown dokumentatsioon - Selge pealkirjade hierarhia -- Koodiblokid koos keele määratlusega -- Lingid täiendavatele ressurssidele -- Ekraanitõmmised ja pildid `images/` kataloogides -- Piltide alternatiivtekst ligipääsetavuse jaoks +- Koodiplokid keelespetsiifikatsiooniga +- Lingid lisamaterjalidele +- Ekraanipildid ja pildid `images/` kaustades +- Piltide alternatiivtekst juurdepääsetavuse jaoks -### Failide korraldus +### Failide organiseerimine -- Õppetunnid nummerdatud järjestikku (1-getting-started-lessons, 2-js-basics jne) -- Igal projektil on `solution/` ja sageli `start/` või `your-work/` kataloogid -- Pildid salvestatud õppetunni-spetsiifilistesse `images/` kaustadesse -- Tõlked asuvad `translations/{language-code}/` struktuuris +- Õppetunnid nummerdatud järjestikustena (1-getting-started-lessons, 2-js-basics jne) +- Igal projektil on `solution/` ja sageli `start/` või `your-work/` kaustad +- Pildid salvestatud õppetundipõhistesse `images/` kaustadesse +- Tõlked struktuuris `translations/{language-code}/` ## Ehitamine ja juurutamine -### Viktoriini rakenduse juurutamine (Azure Static Web Apps) +### Viktoriini äpi juurutamine (Azure Static Web Apps) -Viktoriini rakendus on konfigureeritud Azure Static Web Apps juurutamiseks: +quiz-app on seadistatud Azure Static Web Apps juurutuseks: ```bash cd quiz-app npm run build # Loob dist/ kausta -# Käivitab juurutamise GitHub Actions töövoo kaudu, kui tehakse push main haru +# Hõlbustab juurutamist GitHub Actions töövoo kaudu, kui tehakse push main harule ``` Azure Static Web Apps konfiguratsioon: - **Rakenduse asukoht**: `/quiz-app` -- **Väljundkaust**: `dist` +- **Väljundi asukoht**: `dist` - **Töövoog**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` ### Dokumentatsiooni PDF genereerimine @@ -203,80 +203,80 @@ npm run convert # Genereeri PDF docsist ### Docsify dokumentatsioon ```bash -npm install -g docsify-cli # Installi Docsify globaalselt -docsify serve # Serveeri aadressil localhost:3000 +npm install -g docsify-cli # Installi Docsify globaalalt +docsify serve # Serveri aadressil localhost:3000 ``` -### Projektikohtased ehitused +### Projekti-spetsiifilised ehitused -Igal projekti kataloogil võib olla oma ehitusprotsess: +Igal projektikaustal võib olla oma ehitusprotsess: - Vue projektid: `npm run build` loob tootmispaketid -- Staatilised projektid: ei ole ehitusastet, teenindatakse faile otse +- Staatilised projektid: ehitusetapp puudub, serveeri faile otse -## Pull requestide juhised +## Pull requesti juhised -### Pealkirja vorming +### Pealkirja formaat -Kasutage selgeid, kirjeldavaid pealkirju muudetava valdkonna väljendamiseks: -- `[Quiz-app] Lisa uus viktoriin õppetunnile X` -- `[Lesson-3] Paranda trükiviga terrarium projekti juures` -- `[Translation] Lisa hispaania tõlge õppetunnile 5` -- `[Docs] Uuenda seadistuste juhiseid` +Kasuta selgeid ja kirjeldavaid pealkirju, mis näitavad muudatuste valdkonda: +- `[Quiz-app] Lisa uus viktoriin õppetunni X jaoks` +- `[Lesson-3] Paranda trükk vigu terrarium projektis` +- `[Translation] Lisa hispaania keelne tõlge õppetunnile 5` +- `[Docs] Uuenda seadistusjuhiseid` ### Nõutavad kontrollid -Enne PR esitamist: +Enne PR-i esitamist: 1. **Koodi kvaliteet**: - - Käivitage `npm run lint` mõjutatud projektikaustades - - Parandage kõik lintimise vead ja hoiatused + - Käivita `npm run lint` mõjutatud projektikaustades + - Paranda kõik lintimise vead ja hoiatused -2. **Ehituskontroll**: - - Käivitage vajadusel `npm run build` - - Veenduge, et ehitusvead puuduvad +2. **Ehituse kontrollimine**: + - Käivita vajadusel `npm run build` + - Veendu, et ehitusvigu pole -3. **Lingide kontroll**: - - Testige kõiki markdowni linke - - Kontrollige pildiviiteid +3. **Linkide valideerimine**: + - Testi kõiki markdown linke + - Kontrolli pildiviiteid -4. **Sisu ülevaade**: - - Parandage õigekirja ja grammatikat - - Veenduge, et koodinäited on õiged ja hariduslikud - - Kontrollige, et tõlked säilitavad algse tähenduse +4. **Sisu läbivaatus**: + - Luge ja paranda kirjavead ja grammatika + - Veendu, et koodinäited on korrektsed ja hariduslikud + - Kontrolli, et tõlked säilitavad algse tähenduse ### Panustamise nõuded -- Nõustuge Microsoft CLA-ga (automaatne kontroll esimesel PR-il) -- Järgige [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) -- Vaadake [CONTRIBUTING.md](./CONTRIBUTING.md) üksikasjalike juhiste jaoks -- Lisage PR kirjeldusse teemade numbrid, kui see on asjakohane +- Nõustu Microsofti CLA-ga (automaatkontroll esimese PR-i ajal) +- Järgi [Microsoft Open Source käitumiskoodeksit](https://opensource.microsoft.com/codeofconduct/) +- Vaata üksikasjalikke juhiseid [CONTRIBUTING.md](./CONTRIBUTING.md) failist +- Viita PR kirjelduse juures vajadusel probleemide numbritele ### Ülevaatusprotsess -- PR-e vaatavad läbi hooldajad ja kogukond +- PR-e üle vaatavad hooldajad ja kogukond - Eelistatakse hariduslikku selgust -- Koodinäited peaksid järgima hetke parimaid praktikaid -- Tõlked vaadatakse üle täpsuse ja kultuurilise sobivuse osas +- Koodinäited peaksid järgima hetke parimaid tavasid +- Tõlked vaadatakse läbi täpsuse ja kultuurilise sobivuse huvides ## Tõlkesüsteem ### Automaatne tõlkimine -- Kasutab GitHub Actionsi koos co-op-translator töövooguga -- Tõlgib automaatselt 50+ keelde -- Algsed failid põhikataloogides -- Tõlgitud failid `translations/{language-code}/` kataloogides +- Kasutab GitHub Actions koos co-op-translator töövooga +- Tõlgib automaatselt enam kui 50 keelde +- Allikafailid peamistes kaustades +- Tõlgitud failid kaustades `translations/{language-code}/` -### Käsitsi tõlke paranduste lisamine +### Käsitsi tõlkeparanduste lisamine -1. Leidke fail `translations/{language-code}/` -2. Tehke parandusi säilitades struktuuri -3. Veenduge, et koodinäited töötavad ka edaspidi -4. Testige kõiki lokaliseeritud viktoriiniküsimusi +1. Otsi fail kaustast `translations/{language-code}/` +2. Tee parandused, säilitades struktuuri +3. Veendu, et koodinäited toimivad edasi +4. Testi lokaliseeritud viktoriinisisu ### Tõlkemetaandmed -Tõlgitud failidel on metaandmete päis: +Tõlgitud failidel on metadata päis: ```markdown ``` -## Silumine ja probleemide lahendamine +## Silumine ja tõrkeotsing ### Levinumad probleemid -**Viktoriinirakendus ei käivitu**: -- Kontrollige Node.js versiooni (soovitatav v14+) -- Kustutage `node_modules` ja `package-lock.json`, seejärel käivitage `npm install` -- Kontrollige pordi konflikte (vaikimisi: Vite kasutab porti 5173) +**Viktoriini äpp ei käivitu**: +- Kontrolli Node.js versiooni (v14+ soovitatav) +- Kustuta `node_modules` ja `package-lock.json`, käivita `npm install` uuesti +- Kontrolli pordi konflikte (vaikimisi: Vite kasutab porti 5173) **API server ei käivitu**: -- Veenduge, et Node.js versioon vastab miinimumile (node >=10) -- Kontrollige, kas port on juba kasutusel -- Veenduge, et kõik sõltuvused on installitud käsuga `npm install` +- Veendu, et Node.js versioon vastab minimaalsetele nõuetele (node >=10) +- Kontrolli, kas port on juba kasutuses +- Kontrolli, et kõik sõltuvused on installitud käsklusega `npm install` -**Brauserilaiendust ei laeta**: -- Kontrollige, et manifest.json on korrektselt vormindatud -- Kontrollige brauseri konsooli vigade osas -- Järgige brauserispetsiifilisi laienduse paigaldamise juhiseid +**Brauserilaiendus ei laadi**: +- Kontrolli, et manifest.json on korrektselt vormindatud +- Vaata brauseri konsoolist vigu +- Järgi brauserispetsiifilisi laiendi paigaldamise juhiseid -**Python juturoboti probleemid**: -- Veenduge, et OpenAI pakett on installitud: `pip install openai` -- Kontrollige, et GITHUB_TOKEN keskkonnamuutuja on seatud -- Kontrollige GitHub Models juurdepääsu õiguseid +**Python jutuprojekti probleemid**: +- Veendu, et OpenAI pakett on installitud: `pip install openai` +- Kontrolli, et GITHUB_TOKEN keskkonnamuutuja on seadistatud +- Kontrolli GitHub Models ligipääsu õiguseid -**Docsify ei paku dokumente**: -- Paigaldage globaalselt docsify-cli: `npm install -g docsify-cli` -- Käivitage hoidla juurkataloogist -- Veenduge, et `docs/_sidebar.md` on olemas +**Docsify ei serveeri dokumente**: +- Paigalda globaalne docsify-cli: `npm install -g docsify-cli` +- Käivita hoidla juurkataloogist +- Kontrolli, et `docs/_sidebar.md` olemas -### Arenduskeskkonna näpunäited +### Arenduskeskkonna nõuanded -- Kasutage VS Code'i koos Live Serveri laiendusega HTML projektide jaoks -- Paigaldage ESLint ja Prettier laiendused järjepideva vormindamise jaoks -- Kasutage brauseri arendustööriistu JavaScripti silumiseks -- Vue projektide puhul paigaldage Vue DevTools brauserilaiendus +- Kasuta VS Code Live Server laiendust HTML projektidel +- Paigalda ESLint ja Prettier laiendid järjepidevaks vormindamiseks +- Kasuta brauseri DevTools JavaScripti silumiseks +- Vue projektide jaoks paigalda Vue DevTools brauserilaiendus -### Töövõime kaalutlused +### Jõudlusküsimused -- Suur tõlgitud failide arv (50+ keelt) tähendab, et täiskloonid on suured -- Kasutage siledat klooni, kui töötate ainult sisuga: `git clone --depth 1` -- Välistage tõlked otsingutest, kui töötate inglise sisuga -- Ehituste protsessid võivad olla esmakordsel käivitamisel aeglased (npm install, Vite ehitus) +- Rohkem kui 50 keeles tõlgitud failide arv tähendab, et täielikud kloonid on suured +- Kasuta pindmist klooni, kui töötab ainult sisuga: `git clone --depth 1` +- Väldi tõlgete otsingut ingliskeelse sisu töötamisel +- Ehitamine võib esmakordselt olla aeglane (npm install, Vite ehitus) -## Turvalisuse kaalutlused +## Turvaküsimused ### Keskkonnamuutujad -- API võtmeid ei tohi kunagi hoidlas hoida -- Kasutage `.env` faile (mille .gitignore juba sisaldub) -- Dokumenteerige vajalikud keskkonnamuutujad projektide README-des +- API võtmeid ei tohi kunagi commitida hoidlasse +- Kasuta `.env` faile (juba `.gitignore`-s) +- Dokumenteeri nõutud keskkonnamuutujad projektide README-des ### Python projektid -- Kasutage virtuaalseid keskkondi: `python -m venv venv` -- Hoidke sõltuvused ajakohasena -- GitHubi tokenid peaksid omama minimaalset vajaliku õigustega +- Kasuta virtuaalkeskkondi: `python -m venv venv` +- Hoia sõltuvusi ajakohasena +- GitHub tokenitel peaks olema miinimum vajalikud õigused -### GitHub Modelsi juurdepääs +### GitHub Models ligipääs -- Isiklikud ligipääsutokenid (PAT) vajalikud GitHub Modelsile -- Tokenid tuleb hoida keskkonnamuutujatena -- Ärge kunagi hoidlas hoida tokeneid ega mandaate +- Isikliku ligipääsu tokeni (PAT) nõutakse GitHub Models jaoks +- Toksid tuleks hoida keskkonnamuutujatena +- Mitte kunagi ei commitiks tokeneid ega volitusi -## Lisamärkmed +## Lisamärkused ### Sihtgrupp - Täielikud veebiarenduse algajad -- Õpilased ja iseseisvalt õppijad +- Õpilased ja isetegijad - Õpetajad, kes kasutavad õppekava klassiruumis -- Sisu on loodud juurdepääsetavaks ja oskuste järkjärguliseks ülesehitamiseks +- Sisu on loodud ligipääsetavaks ja oskuste järk-järguliseks arendamiseks -### Hariduslik filosoofia +### Haridusfilosoofia - Projektipõhine õppemeetod -- Sageli toimuvad teadmiste kontrollid (viktoriinid) -- Praktikakood harjutused +- Sageli tehtavad teadmiste kontrollid (viktoriinid) +- Käed-külge kodeerimise harjutused - Reaalmaailma rakenduste näited - Keskendumine põhialustele enne raamistikke ### Hoidla hooldus -- Aktiivne õppijate ja panustajate kogukond +- Aktiivne kogukond õppijate ja panustajatega - Regulaarne sõltuvuste ja sisu uuendamine -- Teemad ja arutelud jälgitud hooldajate poolt -- Tõlke uuendused on automatiseeritud GitHub Actionsi kaudu +- Probleemide ja arutelude jälgimine hooldajate poolt +- Tõlkeuuendused automatiseeritud GitHub Actions abil ### Seotud ressursid - [Microsoft Learn moodulid](https://docs.microsoft.com/learn/) -- [Õpilaste keskuse ressursid](https://docs.microsoft.com/learn/student-hub/) -- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) soovitatav õppijatele -- Täiendavad kursused: Generatiivne AI, Andmeteadus, ML, IoT õppekavad +- [Õpilaskeskuse ressursid](https://docs.microsoft.com/learn/student-hub/) +- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot), soovitatav õppijatele +- Lisa kursused: Generatiivne AI, Andmeteadus, ML, IoT õppekavad saadaval -### Spetsiifiliste projektidega töötamine +### Töötamine spetsiifiliste projektidega -Üksikasjalike juhiste jaoks vaadake iga projekti README faile: -- `quiz-app/README.md` - Vue 3 viktoriinirakendus +Detailse juhendi jaoks üksikprojektidele vaata README faile: +- `quiz-app/README.md` - Vue 3 viktoriini rakendus - `7-bank-project/README.md` - Panga rakendus autentimisega -- `5-browser-extension/README.md` - Brauserilaienduse arendamine -- `6-space-game/README.md` - Canvas-põhine mänguarendus +- `5-browser-extension/README.md` - Brauserilaienduse arendus +- `6-space-game/README.md` - Canvas baasil mängu arendus - `9-chat-project/README.md` - AI juturoboti projekt ### Monorepo struktuur -Kuigi ei ole traditsiooniline monorepo, sisaldab see hoidla mitut sõltumatut projekti: +Kuigi see ei ole traditsiooniline monorepo, sisaldab see hoidla mitut iseseisvat projekti: - Iga õppetund on iseseisev - Projektid ei jaga sõltuvusi -- Töötage individuaalsete projektidega mõjutamata teisi -- Klooni kogu hoidla täiskogemuse saamiseks +- Töötage üksikute projektidega mõjutamata teisi +- Klooni kogu hoidla tervikliku õppekava kogemuse jaoks --- **Vastutusest loobumine**: -See dokument on tõlgitud kasutades tehisintellektil põhinevat tõlke teenust [Co-op Translator](https://github.com/Azure/co-op-translator). Kuigi püüame tagada täpsuse, tuleb arvestada, et automatiseeritud tõlked võivad sisaldada vigu või ebatäpsusi. Originaaldokument selle emakeeles tuleks pidada autoriteetseks allikaks. Olulise teabe puhul soovitatakse kasutada professionaalsete inimtõlkide teenust. Me ei vastuta ühegi arusaamatuse ega valesti tõlgendamise eest, mis võivad tuleneda selle tõlke kasutamisest. +See dokument on tõlgitud AI tõlketeenuse [Co-op Translator](https://github.com/Azure/co-op-translator) abil. Kuigi püüdleme täpsuse poole, palun arvestage, et automaatsed tõlked võivad sisaldada vigu või ebatäpsusi. Algne dokument selle emakeeles tuleks pidada autoriteetseks allikaks. Olulise teabe puhul soovitatakse kasutada professionaalset inimtõlget. Me ei vastuta käesoleva tõlke kasutamisest tulenevate arusaamatuste või valesti tõlgenduste eest. \ No newline at end of file diff --git a/translations/pcm/.co-op-translator.json b/translations/pcm/.co-op-translator.json index 5ce10a31f..cb5a7588c 100644 --- a/translations/pcm/.co-op-translator.json +++ b/translations/pcm/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2026-02-06T10:41:08+00:00", + "translation_date": "2026-02-06T12:12:20+00:00", "source_file": "AGENTS.md", "language_code": "pcm" }, diff --git a/translations/pcm/AGENTS.md b/translations/pcm/AGENTS.md index ee6cacbc6..745d487e9 100644 --- a/translations/pcm/AGENTS.md +++ b/translations/pcm/AGENTS.md @@ -2,27 +2,27 @@ ## Project Overview -Dis na one educational curriculum repository wey dem use teach beginners how dem go sabi web development fundamentals well-well. Di curriculum na correct 12-week course wey Microsoft Cloud Advocates develop, e get 24 hands-on lessons wey cover JavaScript, CSS, and HTML. +Dis na educational curriculum repository wey dem use teach web development fundamentals to beginners. Di curriculum na one complete 12-week course wey Microsoft Cloud Advocates develop, wey get 24 hands-on lessons wey cover JavaScript, CSS, and HTML. ### Key Components -- **Educational Content**: 24 structured lessons wey dem organize inside project-based modules +- **Educational Content**: 24 structured lessons wey arrange inside project-based modules - **Practical Projects**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, and AI Chat Assistant -- **Interactive Quizzes**: 48 quizzes wey each get 3 questions (dem fit use am before and after lesson) -- **Multi-language Support**: Automatic translations for more than 50 languages through GitHub Actions +- **Interactive Quizzes**: 48 quizzes with 3 questions each (pre/post-lesson assessments) +- **Multi-language Support**: Automated translations for 50+ languages via GitHub Actions - **Technologies**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (for AI projects) ### Architecture - Educational repository wey get lesson-based structure -- Every lesson folder get README, code examples, and solutions -- Standalone projects dey for separate directories (quiz-app, different lesson projects) +- Each lesson folder get README, code examples, and solutions +- Standalone projects dey inside separate directories (quiz-app, various lesson projects) - Translation system wey use GitHub Actions (co-op-translator) -- Documentation dey serve through Docsify and dem fit download am as PDF +- Documentation serve through Docsify and e de available as PDF ## Setup Commands -Dis repository na primarily for educational content use. If you wan work with specific projects: +Dis repository na mainly for educational content consumption. To wok with specific projects: ### Main Repository Setup @@ -56,7 +56,7 @@ npm run format # Format wit Prettier ```bash cd 5-browser-extension/solution npm install -# Follow di browser-specific way wey you suppose take load extension dem +# Follow di browser-specific instructions for loading extension ``` ### Space Game Projects @@ -72,7 +72,7 @@ npm install ```bash cd 9-chat-project/solution/backend/python pip install openai -# Set GITHUB_TOKEN environment variable na so +# Set GITHUB_TOKEN environment variable na python api.py ``` @@ -80,29 +80,29 @@ python api.py ### For Content Contributors -1. **Fork di repository** go your own GitHub account +1. **Fork di repository** go your GitHub account 2. **Clone your fork** for your local machine -3. **Create one new branch** for di changes wey you wan do -4. Make changes for lesson content or code examples -5. Test any code changes for di correct project directories -6. Submit pull requests according to how contribution suppose be +3. **Create new branch** for your changes +4. Change lesson content or code examples +5. Test any code changes for the correct project directories +6. Submit pull requests wey follow contribution guidelines ### For Learners 1. Fork or clone di repository -2. Enter lesson directories in order without skipping -3. Read README files for every lesson -4. Do pre-lesson quizzes inside https://ff-quizzes.netlify.app/web/ -5. Work through di code examples for lesson folders +2. Go lesson directories one by one +3. Read README files for each lesson +4. Complete pre-lesson quizzes for https://ff-quizzes.netlify.app/web/ +5. Work through code examples for lesson folders 6. Finish assignments and challenges 7. Take post-lesson quizzes ### Live Development -- **Documentation**: Run `docsify serve` for root (e dey use port 3000) -- **Quiz App**: Run `npm run dev` for quiz-app directory -- **Projects**: Use VS Code Live Server extension to serve HTML projects -- **API Projects**: Run `npm start` inside correct API directories +- **Documentation**: Run `docsify serve` for root (port 3000) +- **Quiz App**: Run `npm run dev` inside quiz-app directory +- **Projects**: Use VS Code Live Server extension for HTML projects +- **API Projects**: Run `npm start` for correct API directories ## Testing Instructions @@ -111,7 +111,7 @@ python api.py ```bash cd quiz-app npm run lint # Check for code style wahala -npm run build # Make sure say build dey successful +npm run build # Make sure say build go succeed ``` ### Bank API Testing @@ -119,62 +119,62 @@ npm run build # Make sure say build dey successful ```bash cd 7-bank-project/api npm run lint # Check for code style wahala -node server.js # Make sure say server dey start without gbege +node server.js # Confirm say server dey start without gbege ``` ### General Testing Approach -- Dis one na educational repository wey no get full automatic tests +- Dis na educational repository without full automated tests - Manual testing dey focus on: - - Code examples dey run without wahala + - Code examples run without error - Links for documentation dey work well - - Project builds dey finish properly - - Examples dey follow correct way wey suppose be + - Project builds complete successfully + - Examples dey follow best practices ### Pre-submission Checks -- Run `npm run lint` for directories wey get package.json -- Make sure markdown links dey valid +- Run `npm run lint` inside directories wey get package.json +- Confirm markdown links dey valid - Test code examples for browser or Node.js -- Check say translations keep di correct structure +- Check say translations still get correct structure ## Code Style Guidelines ### JavaScript - Use modern ES6+ syntax -- Follow standard ESLint configurations wey projects get -- Use meaningful variable and function names for easy understanding -- Add comments wey explain concepts give learners -- Format code with Prettier if e dey configured +- Follow standard ESLint configurations wey projects provide +- Use meaningful variable and function names to help understanding +- Add comments wey explain concepts for learners +- Format with Prettier if e dey configured ### HTML/CSS -- Use correct HTML5 semantic elements -- Follow responsive design principles -- Clear class naming wey dey easy understand -- Comments wey explain CSS methods for learners +- Use semantic HTML5 elements +- Responsive design principles +- Clear class naming styles +- Comments wey explain CSS techniques for learners ### Python - Follow PEP 8 style guidelines -- Clear, educational code examples -- Use type hints where e go help learning +- Use clear, educational code examples +- Add Type hints if e fit help learning ### Markdown Documentation - Clear heading hierarchy -- Code blocks with language tag -- Links to more resources +- Code blocks with language specified +- Links to extra resources - Screenshots and images inside `images/` folders -- Alt text dey for images to help accessibility +- Alt text for images for accessibility ### File Organization -- Lessons numbered one-one (1-getting-started-lessons, 2-js-basics, etc.) -- Every project get `solution/` and sometimes `start/` or `your-work/` folders -- Images dey inside lesson-specific `images/` folders -- Translations dey inside `translations/{language-code}/` folder structure +- Lessons numbered one-after-another (1-getting-started-lessons, 2-js-basics, etc.) +- Each project get `solution/` and normally `start/` or `your-work/` folders +- Images dey for lesson-specific `images/` folders +- Translations dey inside `translations/{language-code}/` folders ## Build and Deployment @@ -184,8 +184,8 @@ Di quiz-app configure for Azure Static Web Apps deployment: ```bash cd quiz-app -npm run build # De create dist/ folder -# De deploy wit GitHub Actions workflow wen you push to main +npm run build # Dey make dist/ folder +# Dey deploy wit GitHub Actions workflow wen dem push for main branch ``` Azure Static Web Apps configuration: @@ -197,27 +197,27 @@ Azure Static Web Apps configuration: ```bash npm install # Install docsify-to-pdf -npm run convert # Mek PDF from docs +npm run convert # Make PDF from docs ``` ### Docsify Documentation ```bash -npm install -g docsify-cli # Make you install Docsify for everywhere -docsify serve # Serve for localhost:3000 +npm install -g docsify-cli # Install Docsify for everywhere for your system +docsify serve # Run am for localhost:3000 ``` ### Project-specific Builds -Every project directory fit get im own build process: +Each project directory fit get im own build process: - Vue projects: `npm run build` dey create production bundles -- Static projects: No build step, files just dey serve directly +- Static projects: No build step, just serve files directly ## Pull Request Guidelines ### Title Format -Use clear, descriptive titles wey show which part you change: +Use clear, descriptive titles wey show di area of change: - `[Quiz-app] Add new quiz for lesson X` - `[Lesson-3] Fix typo for terrarium project` - `[Translation] Add Spanish translation for lesson 5` @@ -228,7 +228,7 @@ Use clear, descriptive titles wey show which part you change: Before you submit PR: 1. **Code Quality**: - - Run `npm run lint` for affected project folders + - Run `npm run lint` for affected project directories - Fix all linting errors and warnings 2. **Build Verification**: @@ -237,41 +237,41 @@ Before you submit PR: 3. **Link Validation**: - Test all markdown links - - Verify say image references dey work + - Confirm image references work 4. **Content Review**: - - Check for spelling and grammar - - Make sure code examples dey correct and educational - - Verify translations keep original meaning + - Proofread for grammar and spelling + - Ensure code examples correct and educational + - Confirm translations maintain original meaning ### Contribution Requirements -- Agree with Microsoft CLA (automatic check for the first PR) +- Agree to Microsoft CLA (e dey automatic on first PR) - Follow [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) -- Read [CONTRIBUTING.md](./CONTRIBUTING.md) for detailed instructions -- Reference issue numbers inside PR description if e dey +- Check [CONTRIBUTING.md](./CONTRIBUTING.md) for detailed guidelines +- Reference issue numbers inside PR description if necessary ### Review Process -- PRs dey reviewed by maintainers and community -- Educational clarity dey very important -- Code examples must follow current best practices -- Translations dey reviewed for accuracy and cultural fit +- PRs go through review by maintainers and community +- Educational clarity dey priority +- Code examples suppose follow current best practices +- Translations go through review for correctness and cultural appropriateness ## Translation System ### Automated Translation -- Dem dey use GitHub Actions with co-op-translator workflow -- Dem dey translate to more than 50 languages automatically +- E dey use GitHub Actions with co-op-translator workflow +- E dey translate to 50+ languages automatically - Source files dey main directories -- Translated files dey inside `translations/{language-code}/` directories +- Translated files dey inside `translations/{language-code}/` folders ### Adding Manual Translation Improvements -1. Find file for `translations/{language-code}/` -2. Improve am but keep di structure -3. Make sure code examples still dey work well +1. Find file inside `translations/{language-code}/` +2. Make improvements but keep original structure +3. Make sure code examples still dey work 4. Test any localized quiz content ### Translation Metadata @@ -293,116 +293,116 @@ CO_OP_TRANSLATOR_METADATA: ### Common Issues -**Quiz app no dey start**: -- Check Node.js version (v14+ na di recommendation) -- Delete `node_modules` and `package-lock.json`, then run `npm install` again -- Check for port conflicts (default: Vite dey use port 5173) +**Quiz app no fit start**: +- Check Node.js version (v14+ recommended) +- Delete `node_modules` and `package-lock.json`, run `npm install` again +- Check port conflicts (Vite normally use port 5173) -**API server no dey start**: -- Confirm Node.js version don reach minimum (node >=10) -- Check if port don already dey use -- Make sure all dependencies don install with `npm install` +**API server no fit start**: +- Confirm Node.js version at least (node >=10) +- Check if port dey already in use +- Make sure all dependencies install with `npm install` **Browser extension no dey load**: -- Check manifest.json make e dey correct format -- Look browser console for errors -- Follow browser specific instruction to install extension +- Confirm manifest.json proper format +- Check browser console for errors +- Follow browser-specific extension installation instructions **Python chat project wahala**: -- Confirm say OpenAI package don install: `pip install openai` -- Check GITHUB_TOKEN environment variable dey set -- Verify GitHub Models access permissions +- Confirm OpenAI package install: `pip install openai` +- Confirm GITHUB_TOKEN environment variable set +- Check GitHub Models access permissions **Docsify no dey serve docs**: - Install docsify-cli globally: `npm install -g docsify-cli` -- Run inside repository root directory -- Check say `docs/_sidebar.md` dey +- Run am from repository root directory +- Confirm say `docs/_sidebar.md` dey ### Development Environment Tips - Use VS Code with Live Server extension for HTML projects -- Install ESLint and Prettier extensions to maintain formatting style +- Install ESLint and Prettier extensions for consistent formatting - Use browser DevTools to debug JavaScript - For Vue projects, install Vue DevTools browser extension ### Performance Considerations -- Plenty translated files (50+ languages) mean big clones -- Use shallow clone if na only content you dey work on: `git clone --depth 1` -- Exclude translations from search when you dey work on English content +- Big number of translated files (50+ languages) mean full clones big +- Use shallow clone if you dey work only on content: `git clone --depth 1` +- Exclude translations from searches if you dey work on English content - Build processes fit slow for first run (npm install, Vite build) ## Security Considerations ### Environment Variables -- API keys no suppose ever enter repository +- API keys no suppose commit inside repository - Use `.env` files (dem already dey `.gitignore`) -- Document which environment variables needed for projects READMEs +- Document which environment variables project READMEs need ### Python Projects - Use virtual environments: `python -m venv venv` - Keep dependencies updated -- GitHub tokens must get minimal permissions +- GitHub tokens suppose get minimal permissions ### GitHub Models Access -- Personal Access Tokens (PAT) na im you go use for GitHub Models -- Keep tokens as environment variables -- Never commit tokens or credentials +- Personal Access Tokens (PAT) necessary for GitHub Models +- Tokens suppose dey stored as environment variables +- No ever commit tokens or credentials ## Additional Notes ### Target Audience - Complete beginners for web development -- Students and people wey dey learn by themselves +- Students and self-learners - Teachers wey dey use curriculum for classrooms -- Content design dey accessible and skills dey build gradually +- Content design for accessibility and gradual skill building ### Educational Philosophy -- Project-based learning method -- Frequent quizzes for check knowledge +- Project-based learning approach +- Frequent knowledge checks (quizzes) - Hands-on coding exercises - Real-world application examples -- Focus on fundamentals before dem start framework +- Focus on fundamentals before frameworks ### Repository Maintenance - Active community of learners and contributors - Regular updates to dependencies and content -- Maintainers dey monitor issues and discussions -- Translation updates dey automatic with GitHub Actions +- Issues and discussions dey monitored by maintainers +- Translation updates automatic with GitHub Actions ### Related Resources - [Microsoft Learn modules](https://docs.microsoft.com/learn/) - [Student Hub resources](https://docs.microsoft.com/learn/student-hub/) -- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) wey dey recommended for learners -- Other courses: Generative AI, Data Science, ML, IoT curricula dey available +- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) recommended for learners +- Additional courses: Generative AI, Data Science, ML, IoT curricula dey available ### Working with Specific Projects -For detailed instructions about individual projects, check README files for: +For detailed instructions about each project, check README files inside: - `quiz-app/README.md` - Vue 3 quiz application -- `7-bank-project/README.md` - Banking app with authentication +- `7-bank-project/README.md` - Banking application with authentication - `5-browser-extension/README.md` - Browser extension development - `6-space-game/README.md` - Canvas-based game development - `9-chat-project/README.md` - AI chat assistant project ### Monorepo Structure -Even though e no be traditional monorepo, dis repository get plenty independent projects: -- Every lesson self-contained +Even though e no traditional monorepo, dis repository get plenty independent projects: +- Each lesson self-contained - Projects no dey share dependencies -- You fit work on single projects without affect others -- Clone whole repo if you want full curriculum experience +- Work on individual projects without affecting others +- Clone whole repo to get full curriculum experience --- **Disclaimer**: -Dis document dem translate am wit AI translation service [Co-op Translator](https://github.com/Azure/co-op-translator). We dey try make am correct, but abeg make you sabi say automated translation fit get some errors or mistakes. Di original document wey e dey for im own language na di correct source. For important info, make person wey sabi do professional human translation handle am. We no go responsible for any misunderstanding or wrong interpretation wey fit happen because of dis translation. +Dis document don translate wit AI translation service [Co-op Translator](https://github.com/Azure/co-op-translator). Even tho we dey try make am correct, abeg sabi say automated translation fit get mistake or no too correct. Di original document wey pure for im own language na di main correct source. For important tin dem, e better make person wey sabi do professional translation make am. We no go follow any wahala or mistake Wey fit show because of dis translation. \ No newline at end of file diff --git a/translations/te/.co-op-translator.json b/translations/te/.co-op-translator.json index d0c75d27e..10cb9e892 100644 --- a/translations/te/.co-op-translator.json +++ b/translations/te/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2026-02-06T10:42:29+00:00", + "translation_date": "2026-02-06T12:13:33+00:00", "source_file": "AGENTS.md", "language_code": "te" }, diff --git a/translations/te/AGENTS.md b/translations/te/AGENTS.md index 8f2671157..7cf40f628 100644 --- a/translations/te/AGENTS.md +++ b/translations/te/AGENTS.md @@ -1,47 +1,47 @@ # AGENTS.md -## ప్రాజెక్ట్ అవగాహన +## Project Overview -ఇది ప్రారంభాలకు వెబ్ డెవలప్‌మెంట్ ఫండమెంటల్స్ నేర్పడానికి ఒక విద్యా పాఠ్యాంశాల రిపాజిటరీ. ఈ పాఠ్యాంశం Microsoft Cloud Advocates ద్వారా అభివృద్ధి చేయబడిన 12 వారాల పూర్తి కోర్సును అందిస్తుంది, ఇందులో JavaScript, CSS, మరియు HTML పై 24 ప్రాక్టికల్ పాఠాలు ఉంటాయి. +ఇది ప్రారంభ దశలో ఉన్నవారికి వెబ్ అభివృద్ధి ప్రాథమికాలు బోధించడానికి రూపొందించిన విద్యా పాఠ్యక్రమ కంప్యూటర్‌స్టోర్. ఈ పాఠ్యక్రమం Microsoft Cloud Advocates ద్వారా అభివృద్ధి చేయబడిన సమగ్రమైన 12 వారాలు కోర్సు, దీనిలో JavaScript, CSS, మరియు HTML ను కవరుచేసే 24 చేతితో పని చేసే పాఠాలు ఉన్నాయి. -### ప్రధాన భాగాలు +### Key Components -- **విద్యా విషయాలు**: ప్రాజెక్ట్ ఆధారిత మాడ్యూల్స్‌లో 24 నిర్మిత పాఠాలు -- **ప్రాక్టికల్ ప్రాజెక్టులు**: Terrarium, టైపింగ్ గేమ్, బ్రౌజర్ ఎక్స్‌టెన్షన్, స్పేస్ గేమ్, బ్యాంకింగ్ యాప్, కోడ్ ఎడిటర్, మరియు AI చాట్ అసిస్టెంట్ -- **ఇంటరాక్టివ్ క్విజ్‌లు**: ప్రతి పాఠానికి 3 ప్రశ్నల 48 క్విజ్‌లు (పూర్వ/తరువాత అచ్చులు) -- **బహుభాషా మద్దతు**: GitHub Actions ద్వారా 50+ భాషల స్వయంచాలక అనువాదాలు +- **విద్యా విషయం**: ప్రాజెక్టు ఆధారిత మాడ్యూల్స్ లో 24 నిర్మిత పాఠాలు +- **ప్రాక్టికల్ ప్రాజెక్టులు**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, మరియు AI చాట్ అసిస్టెంట్ +- **ఇంటరాక్టివ్ క్విజ్‌లు**: 3 ప్రశ్నలతో 48 క్విజ్‌లు (పాఠం ముందు / తర్వాత మూల્યાંకనలు) +- **బహుభాషా మద్దతు**: GitHub Actions ద్వారా 50+ భాషల ఆటోమెటెడ్ అనువాదాలు - **సాంకేతికతలు**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI ప్రాజెక్టులకు) -### నిర్మాణం +### Architecture -- పాఠాల ఆధారంగా విద్యా రిపాజిటరీ -- ప్రతి పాఠపు ఫోల్డర్ README, కోడ్ ఉదాహరణలు, మరియు పరిష్కారాలను కలిగి ఉంటుంది -- స్వతంత్ర ప్రాజెక్టులు వేరే డైరెక్టరీలలో (quiz-app, వివిధ పాఠ ప్రాజెక్టులు) -- GitHub Actions ఉపయోగించే అనువాద సిస్టమ్ (co-op-translator) -- Docsify ద్వారా డాక్యుమెంటేషన్ అందించబడుతుంది మరియు PDF రూపంలో లభిస్తుంది +- పాఠ్యాల ఆధారంగా నిర్మిత విద్యా కంప్యూటర్‌స్టోర్ +- ప్రతి పాఠం ఫోల్డర్‌లో README, కోడ్ ఉదాహరణలు మరియు పరిష్కారాలు ఉంటాయి +- క్విజ్-యాప్, వివిధ పాఠ ప్రాజెక్టులు వేర్వేరు డైరెక్టరీలలో నిల్వ +- GitHub Actions ఉపయోగించి అనువాద వ్యవస్థ (co-op-translator) +- Docsify ద్వారా డాక్యుమెంటేషన్ అందుబాటులో, PDF లాగా అందుబాటు -## సెటప్ కమాండ్లు +## Setup Commands -ఈ రిపాజిటరీ ప్రధానంగా విద్యా విషయాలు అధ్యయనం కోసం. నిర్దిష్ట ప్రాజెక్టులతో పనిచేయడానికి: +ఈ కంప్యూటర్‌స్టోర్ ప్రాథమికంగా విద్యా విషయాలను వినియోగించుకోుము కోసం ఉంది. నిర్దిష్ట ప్రాజెక్టులతో పనిచేయడానికి: -### ప్రధాన రిపాజిటరీ సెటప్ +### Main Repository Setup ```bash git clone https://github.com/microsoft/Web-Dev-For-Beginners.git cd Web-Dev-For-Beginners ``` -### క్విజ్ యాప్ సెటప్ (Vue 3 + Vite) +### Quiz App Setup (Vue 3 + Vite) ```bash cd quiz-app npm install -npm run dev # అభివృద్ధి సర్వర్‌ను ప్రారంభించండి -npm run build # ఉత్పత్తి కోసం సృష్టించు -npm run lint # ESLint ను నడపండి +npm run dev # అభివృద్ధి సర్వర్ ను ప్రారంభించండి +npm run build # ఉత్పత్తి కోసం నిర్మించండి +npm run lint # ESLint ను నిర్వహించండి ``` -### బ్యాంక్ ప్రాజెక్ట్ API (Node.js + Express) +### Bank Project API (Node.js + Express) ```bash cd 7-bank-project/api @@ -51,232 +51,232 @@ npm run lint # ESLint నడపండి npm run format # Prettier తో ఫార్మాట్ చేయండి ``` -### బ్రౌజర్ ఎక్స్టెన్షన్ ప్రాజెక్టులు +### Browser Extension Projects ```bash cd 5-browser-extension/solution npm install -# బ్రౌజర్-స్పెసిఫిక్ ఎక్స్‌టెన్షన్ లోడ్ చేసే సూచనలను అనుసరించండి +# బ్రౌసర్-ప్రత్యేక సవరణ లోడ్ చేయడం సంబంధిత సూచనలను అనుసరించండి ``` -### స్పేస్ గేమ్ ప్రాజెక్టులు +### Space Game Projects ```bash cd 6-space-game/solution npm install -# బ్రౌసర్‌లో index.html ను తెరవండి లేదా Live Server ఉపయోగించండి +# బ్రౌజర్‌లో index.html ను తెరవండి లేదా లైవ్ సర్వర్‌ని ఉపయోగించండి ``` -### చాట్ ప్రాజెక్ట్ (Python బ్యాక్‌ఎండ్) +### Chat Project (Python Backend) ```bash cd 9-chat-project/solution/backend/python pip install openai -# GITHUB_TOKEN окружение మార్పిడి సెట చేయండి +# GITHUB_TOKEN పర్యావరణ వేరియబుల్ సెట్ చేయండి python api.py ``` -## అభివృద్ధి పనితీరు +## Development Workflow -### కంటెంట్ కాంట్రిబ్యూటర్ల కోసం +### For Content Contributors -1. మీ GitHub ఖాతాకు రిపాజిటరీని **ఫోর্ক్** చేయండి -2. మీ ఫోర్క్‌ను లొకల్గా **క్లోన్** చేయండి -3. మార్పుల కోసం కొత్త బ్రాంచ్ సృష్టించండి -4. పాఠం కంటెంట్ లేదా కోడ్ ఉదాహరణల్లో మార్పులు చేయండి -5. సంబంధిత ప్రాజెక్ట్ డైరెక్టరీలలో ఎప్పటికప్పుడు కోడ్ తనిఖీ చేయండి -6. సహకార మార్గదర్శకాలు ప్రకారం పుల్ రిక్వెస్టులు సబ్మిట్ చేయండి +1. **మీ GitHub ఖాతాకు ఈ కంప్యూటర్‌స్టోర్ ను Fork చేయండి** +2. **మీ Fork ను స్థానికంగా Clone చేయండి** +3. **మీ మార్పులకు కొత్త బ్రాంచ్ సృష్టించండి** +4. పాఠ విషయాలు లేదా కోడ్ ఉదాహరణల్లో మార్పులు చేయండి +5. సంబంధిత ప్రాజెక్టు డైరెక్టరీలలో కోడ్ మార్పులను పరీక్షించండి +6. సహకార మార్గదర్శకాలు పర్యవేక్షించి Pull Requests సమర్పించండి -### అధ్యయనకర్తల కోసం +### For Learners -1. రిపాజిటరీని ఫోర్క్ లేదా క్లోన్ చేయండి -2. పాఠం డైరెక్టరీలను వరుసగా అనుసరించండి -3. ప్రతి పాఠానికి README ఫైల్స్ చదవండి -4. ముందస్తు పాఠం క్విజ్‌లు పూర్తి చేయండి https://ff-quizzes.netlify.app/web/ -5. పాఠ ఫోల్డర్లలో కోడ్ ఉదాహరణలపై పనిచేయండి -6. అసైన్మెంట్లు మరియు చాలెంజ్‌లు పూర్తి చేయండి -7. పాఠం తరువాత క్విజ్‌లు పూర్తి చేయండి +1. Fork చేయండి లేదా కంప్యూటర్‌స్టోర్ ను Clone చేయండి +2. పాఠ డైరెక్టరీలను వరుసగా సందర్శించండి +3. ప్రతి పాఠం README ఫైల్స్ చదవండి +4. https://ff-quizzes.netlify.app/web/ వద్ద పాఠం ముందు క్విజ్‌లను పూర్తి చేయండి +5. పాఠ ఫోల్డర్లలో కోడ్ ఉదాహరణలలో పని చేయండి +6. అసైన్మెంట్లు మరియు సవాళ్లను పూర్తి చేయండి +7. పాఠం తర్వాత క్విజ్‌లు తీసుకోండి -### ప్రత్యక్ష అభివృద్ధి +### Live Development -- **డాక్యుమెంటేషన్**: రూట్‌లో `docsify serve` నడపండి (పోర్ట్ 3000) +- **డాక్యుమెంటేషన్**: రూట్ డైరెక్టరీలో `docsify serve` నడపండి (పోర్ట్ 3000) - **క్విజ్ యాప్**: quiz-app డైరెక్టరీలో `npm run dev` నడపండి -- **ప్రాజెక్టులు**: HTML ప్రాజెక్టులకు VS Code Live Server ఎక్స్టెన్షన్ ఉపయోగించండి +- **ప్రాజెక్టులు**: HTML ప్రాజెక్టులకు VS Code Live Server extension ఉపయోగించండి - **API ప్రాజెక్టులు**: సంబంధిత API డైరెక్టరీలలో `npm start` నడపండి -## పరీక్షా సూచనలు +## Testing Instructions -### క్విజ్ యాప్ పరీక్ష +### Quiz App Testing ```bash cd quiz-app npm run lint # కోడ్ శైలీ సమస్యలను తనిఖీ చేయండి -npm run build # బిల్డ్ విజయవంతమవుతుందని ధృవీకరించండి +npm run build # బిల్డ్ విజయవంతమైందని నిర్ధారించండి ``` -### బ్యాంక్ API పరీక్ష +### Bank API Testing ```bash cd 7-bank-project/api -npm run lint # కోడ్ శైలి స‌మ‌స్య‌ల కోసం తనిఖీ చేయండి -node server.js # సర్వర్ ఎర్రర్స్ లేకుండా ప్రారంభమవుతుందో పరీక్షించండి +npm run lint # కోడ్ శైలిలో సమస్యలు ఉన్నా లేకపోయినా తనిఖీ చేయండి +node server.js # సర్వర్ తప్పుల్లేకుండా ప్రారంభమవుతుందో తనిఖీ చేయండి ``` -### సాధారణ పరీక్షా పদ্ধతి +### General Testing Approach -- ఇది పూర్తి ఆటోమేటెడ్ టెస్టులు లేని విద్యా రిపాజిటరీ -- మాన్యువల్ టెస్టింగ్ ఆకర్షణీయాంశాలు: - - కోడ్ ఉదాహరణలు తప్పులేకుండా నడవడం - - డాక్యుమెంటేషన్ లింకులు సరిగ్గా పనిచేయడం - - ప్రాజెక్ట్ బిల్డ్లు విజయవంతం కావడం - - ఉదాహరణలు ఉత్తమ మార్గదర్శకాలతో ఉండటము +- ఇది సమగ్ర ఆటోమేటెడ్ పరీక్షలు లేని విద్యా కంప్యూటర్‌స్టోర్ +- మాన్యువల్ పరీక్షలు ఫోకస్: + - కోడ్ ఉదాహరణలు లో ఎర్రర్లు లేని విధంగా పనిలో ఉండాలి + - డాక్యుమెంటేషన్ లో లింకులు సరిగా పని చేయాలి + - ప్రాజెక్ట్ బిల్డ్స్ విజయవంతంగా పూర్తవాలి + - ఉదాహరణలు ఉత్తమ ప్రవర్తనలు పాటించాలి -### సబ్మిషన్‌కు ముందు తనిఖీలు +### Pre-submission Checks - package.json ఉన్న డైరెక్టరీలలో `npm run lint` నడపండి -- మార్క్డౌన్ లింకులు చెల్లుబాటు అయ్యాయో కన్ఫర్మ్ చేయండి +- మార్క్డౌన్ లింకులు సరిచూడండి - బ్రౌజర్ లేదా Node.js లో కోడ్ ఉదాహరణలు పరీక్షించండి -- అనువాదాలు సరైన నిర్మాణం కలిగినట్లు చూసుకోండి +- అనువాదాలు సరైన నిర్మాణాన్ని కలిగి ఉండేలా చూసుకోండి -## కోడ్ శైలి మార్గదర్శకాలు +## Code Style Guidelines ### JavaScript -- ఆధునిక ES6+ వాక్యరచన ఉపయోగించండి -- ప్రాజెక్టుల్లో ఉంచబడిన ESLint కాన్ఫిగరేషన్ తిరగండి -- విద్యార్థులకు స్పష్టమైన వేరియబుల్ మరియు ఫంక్షన్ పేర్లు ఎంచుకోండి -- పాఠార్థం సూచించే వ్యాఖ్యలు జోడించండి -- Prettier స్థాపించబడిన చోట ఉపయోగించండి +- ఆధునిక ES6+ సింటాక్స్ ఉపయోగించండి +- ప్రాజెక్టుల్లో ఇచ్చిన ESLint కాన్ఫిగరేషన్లను అనుసరించండి +- విద్యా స్పష్టత కొరకు అర్థవంతమైన వేరియబుల్, ఫంక్షన్ పేర్లను ఉపయోగించండి +- అభ్యాసకులకు భావనలు వివరించే కామెంట్స్ జోడించండి +- సక్రమంగా Prettier ను ఉపయోగించి ఫార్మాట్ చేయండి ### HTML/CSS -- సాంకేతికార్థ HTML5 మూలకాలు ఉపయోగించండి -- స్పందనాత్మక డిజైన్ సువిధాల పాటించండి -- స్పష్టమైన క్లాస్ నేమింగ్ కన్వెన్షన్లు -- విద్యార్థులకు CSS సాంకేతికతలు వివరిస్తూ వ్యాఖ్యలు +- సేమాంటిక్ HTML5 ఎలిమెంట్స్ +- రెస్పాన్సివ్ డిజైన్ సూత్రాలు +- స్పష్టమైన క్లాస్ నామకరణ పద్ధతులు +- CSS సాంకేతికతలను వివరించే కామెంట్లు ### Python -- PEP 8 శైలీ మార్గదర్శకాలు పాటించండి -- స్పష్టమైన విద్యా కోడ్ ఉదాహరణలు -- అవసరమైతే టైప్ హింట్లు జోడించండి +- PEP 8 స్టైల్ మార్గదర్శకాలు +- స్పష్టమైన, విద్యా పరమైన కోడ్ ఉదాహరణలు +- అభ్యాసకులకు ఉపయోగకరమైన చోట టైప్ హింట్స్ -### మార్క్డౌన్ డాక్యుమెంటేషన్ +### Markdown Documentation -- స్పష్టమైన శీర్షిక సరళి -- భాష నిర్దేశంతో కోడ్ బ్లాక్స్ -- అదనపు వనరులకు లింకులు -- `images/` డైరెక్టరీలో స్క్రీన్షాట్లు మరియు చిత్రాలు -- ప్రాప్తి సౌకర్యానికి చిత్రాల కోసం అల్ట్ టెక్స్ట్ +- స్పష్టమైన శీర్షిక జైలిమవర్డ్ +- భాషా పేర్కొన్న కోడ్ బ్లాక్స్ +- అదనపు వనరుల లింకులు +- `images/` ఫోల్డర్లలో స్క్రీన్‌షాట్‌లు మరియు చిత్రాలు +- యాక్సెసిబిలిటీకి చిత్రాల alt పాఠ్యం -### ఫైల్ నిర్వహణ +### File Organization -- పాఠాలు వరుసగా నంబరింగ్: (1-getting-started-lessons, 2-js-basics, మొదలగు) -- ప్రతి ప్రాజెక్ట్‌కు `solution/` మరియు తరచుగా `start/` లేదా `your-work/` డైరెక్టరీలు ఉంటాయి -- పాఠ స్పష్టిత చిత్రాలు `images/` ఫోల్డర్లలో నిల్వ -- అనువాదాలు `translations/{language-code}/` నిర్మాణంలో +- పాఠాలు వరుసగా సంఖ్యలతో (1-getting-started-lessons, 2-js-basics, మొదలగు) +- ప్రతి ప్రాజెక్ట్ లో `solution/` మరియు తరచుగా `start/` లేదా `your-work/` డైరెక్టరీలు ఉంటాయి +- పాఠ-ప్రత్యేక `images/` ఫోల్డర్లలో చిత్రాలు నిల్వ +- అనువాదాలు `translations/{language-code}/` నిర్మాణంలో ఉంటాయి -## బిల్డ్ మరియు ప్రవేశపొందింపు +## Build and Deployment -### క్విజ్ యాప్ డిప్లాయ్‌మెంట్ (Azure Static Web Apps) +### Quiz App Deployment (Azure Static Web Apps) -క్విజ్-యాప్ Azure Static Web Apps డిప్లాయ్‌మెంట్‌కు సెట్ చేయబడింది: +క్విజ్-యాప్ Azure Static Web Apps ప్రవేశపెట్టడానికి బాగా సర్దుబాటు చేయబడింది: ```bash cd quiz-app -npm run build # dist/ ఫోల్డర్‌ను సృష్టిస్తుంది -# మెయిన్‌‌కు పుష్ చేసినప్పుడు GitHub Actions వర్క్‌ఫ్లో ద్వారా నియోజితం చేస్తుంది +npm run build # dist/ ఫోల్డర్ సృష్టిస్తుంది +# ప్రధాన బ్రాంచ్‌కు పుష్ చేసినప్పుడు GitHub Actions వర్క్‌ఫ్లో ద్వారా పంపిస్తుంది ``` -Azure Static Web Apps ఆకృతీకరణ: -- **యాప్ స్థలం**: `/quiz-app` -- **ఫలిత స్థలం**: `dist` -- **వర్క్‌ఫ్లో**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` +Azure Static Web Apps కాన్ఫిగరేషన్: +- **App location**: `/quiz-app` +- **Output location**: `dist` +- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` -### డాక్యుమెంటేషన్ PDF రూపొందింపు +### Documentation PDF Generation ```bash -npm install # docsify-to-pdf ను ఇన్స్టాల్ చేయండి +npm install # docsify-to-pdf ను ఇన్‌స్టాల్ చేయండి npm run convert # docs నుండి PDF ను సృష్టించండి ``` -### Docsify డాక్యుమెంటేషన్ +### Docsify Documentation ```bash -npm install -g docsify-cli # Docsify ని గ్లోబల్‌గా ఇన్స్టాల్ చేయండి -docsify serve # localhost:3000 వద్ద సర్వ్ చేయండి +npm install -g docsify-cli # Docsify ని గ్లోబల్గా ఇన్‌స్టాల్ చేయండి +docsify serve # localhost:3000 పై సర్వ్ చేయండి ``` -### ప్రాజెక్ట్-స్పెసిఫిక్ బిల్డ్లు +### Project-specific Builds -ప్రతి ప్రాజెక్ట్ డైరెక్టరీకు తనకు తాను బిల్డ్ ప్రক্রియ ఉండవచ్చు: -- Vue ప్రాజెక్టులు: `npm run build` ప్రొడక్షన్ బండిల్స్ సృష్టిస్తుంది -- స్థిరమైన ప్రాజెక్టులు: బిల్డ్ అవసరం లేదు, ఫైళ్లను నేరుగా సర్వ్ చేయండి +ప్రతి ప్రాజెక్ట్ డైరెక్టరీకు తన ప్రత్యేక బిల్డ్ ప్రక్రియ ఉండవచ్చు: +- Vue ప్రాజెక్టులు: `npm run build` ద్వారా ప్రొడక్షన్ బండిల్స్ సృష్టించబడతాయి +- స్టాటిక్ ప్రాజెక్టులు: బిల్డ్ దశ ఉండదు, ఫైళ్ళను నేరుగా సర్వ్ చేస్తారు -## పుల్ రిక్వెస్ట్ మార్గదర్శకాలు +## Pull Request Guidelines -### శీర్షిక ఫార్మాట్ +### Title Format -మార్పు ప్రాంతాన్ని స్పష్టంగా తెలియజేయండి: -- `[Quiz-app] Add new quiz for lesson X` -- `[Lesson-3] Fix typo in terrarium project` -- `[Translation] Add Spanish translation for lesson 5` -- `[Docs] Update setup instructions` +మార్పుల ప్రాంతాన్ని స్పష్టంగా తెలిపే శీర్షికలను ఉపయోగించండి: +- `[Quiz-app] పాఠం X కోసం కొత్త క్విజ్ జోడించండి` +- `[Lesson-3] terrarium ప్రాజెక్టులో టైపో సరిదిద్దండి` +- `[Translation] పాఠం 5కి స్పానిష్ అనువాదం జోడించండి` +- `[Docs] సెటప్ సూచనలను నవీకరించండి` -### అవసరమైన తనిఖీలు +### Required Checks -PR ఇవ్వడానికి ముందు: +PR సమర్పించేముందు: 1. **కోడ్ నాణ్యత**: - ప్రభావిత ప్రాజెక్ట్ డైరెక్టరీలలో `npm run lint` నడపండి - - అన్ని లింట్ తప్పులు మరియు హెచ్చరికలు సరిచూడండి + - అన్ని లింటింగ్ లోపాలు మరియు హెచ్చరికలు సరి చేసుకోండి -2. **బిల్డ్ ధృవీకరణ**: +2. **బిల్డ్ నిర్ధారణ**: - అవసరమైతే `npm run build` నడపండి - - బిల్డ్ లో తప్పులు లేవని నిర్ధారించండి + - ఎలాంటి బిల్డ్ లోపాలు లేవని నిర్ధారించండి 3. **లింక్ ధృవీకరణ**: - - అన్ని మార్క్డౌన్ లింకులు పరీక్షించండి - - చిత్రం రిఫరెన్సులనూ నిర్ధారించండి + - అన్ని మార్క్డౌన్ లింకులను పరీక్షించండి + - చిత్రం సూచనలు పనిచేస్తున్నాయో చూడండి -4. **కంటెంట్ సమీక్ష**: - - దోషాలు మరియు వ్యాకరణం చెక్ చేయండి - - కోడ్ ఉదాహరణలు సరైనవిగా ఉండాలని చూసుకోండి - - అనువాదాలు అసలు అర్థం నిలుపుకోవటం నిర్ధారించండి +4. **విషయ సమీక్ష**: + - వ్రాత తప్పులు మరియు వ్యాకరణం పర్యవేక్షించండి + - కోడ్ ఉదాహరణలు సరి అయినవి మరియు విద్యా పరంగా సరైనవి ఉన్నాయో చూడండి + - అనువాదాలు మూలార్థాన్ని నిలుపుకుంటున్నాయో నిర్ధారించండి -### సహకార అవసరాలు +### Contribution Requirements -- Microsoft CLA కి అంగీకరించండి (మొదటి PR లో ఆటోమేటెడ్ తనిఖీ) -- [Microsoft ఓపెన్ సోర్స్ కోడ్ ఆఫ్ కండక్ట్](https://opensource.microsoft.com/codeofconduct/) పాటించండి -- [CONTRIBUTING.md](./CONTRIBUTING.md) లో వివరాలు చదవండి -- PR వివరణలో సంబంధిత ఇష్యూ నంబర్లను గుర్తించండి +- Microsoft CLAను అంగీకరించాలి (మొదటి PRలో ఆటోమేటెడ్ తనిఖీ) +- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) ను అనుసరించండి +- పూర్తి మార్గదర్శకాలకు [CONTRIBUTING.md](./CONTRIBUTING.md) ను చూడండి +- PR వివరణలో సంబంధిత ఇష్యూ సంఖ్యలను సూచించండి -### సమీక్షా ప్రక్రియ +### Review Process -- PRలను మెంటైనర్లు మరియు కమ్యూనిటీ సమీక్షిస్తారు -- విద్యా స్పష్టతకు ప్రాధాన్యం ఇవ్వబడుతుంది -- కోడ్ ఉదాహరణలు తాజా ఉత్తమ పద్ధతులకు అనుగుణంగా ఉండాలి -- అనువాదాలు సరిగ్గా మరియు సాంస్కృతికంగా సరిపోవాలి +- PRలు సంరక్షకులు మరియు సమాజం ద్వారా సమీక్షించబడతాయి +- విద్యా స్పష్టత ముఖ్యంగా పరిగణించబడుతుంది +- కోడ్ ఉదాహరణలు ప్రస్తుత ఉత్తమ నియమాలను అనుసరించాలి +- అనువాదాలు సరికొత్త విషయం మరియు సంస్కృతిక అనుకూలత కుదుర్చబడతాయి -## అనువాద సిస్టమ్ +## Translation System -### ఆటోమేటెడ్ అనువాదం +### Automated Translation -- GitHub Actions లో co-op-translator వర్క్‌ఫ్లో ఉపయోగిస్తుంది -- 50+ భాషలకు స్వయంచాలకంగా అనువదిస్తుంది -- మూల ఫైళ్ళు ప్రధాన డైరెక్టరీలలో ఉంటాయి -- అనువాద ఫైళ్లు `translations/{language-code}/` లో ఉంటాయి +- GitHub Actions తో co-op-translator workflow ఉపయోగిస్తుంది +- 50+ భాషలకు ఆటోమేటెడ్ అనువాదాలు చేస్తుంది +- మూల ఫైల్స్ ప్రధాన డైరెక్టరీలలో ఉంటాయి +- అనువాద ఫైల్స్ `translations/{language-code}/` లో ఉంటాయి -### మాన్యువల్ అనువాద అభివృద్ధులు చేర్పు +### Adding Manual Translation Improvements -1. `translations/{language-code}/` లో ఫైల్ కనుగొనండి -2. నిర్మాణం నిలుపుకొని అభివృద్ధులు చేయండి -3. కోడ్ ఉదాహరణలు పనిచేయాల్సినట్లుగా చూసుకోండి -4. స్థానికీకృత క్విజ్ కంటెంట్ పరీక్షించండి +1. `translations/{language-code}/` లో ఫైల్‌ను కనుగొనండి +2. నిర్మాణాన్ని ఉంచుతూ మెరుగులు చేయండి +3. కోడ్ ఉదాహరణలు పనిచేస్తున్నాయని నిర్ధారించండి +4. స్థానికీకరించిన క్విజ్ విషయాలను పరీక్షించండి -### అనువాద మెటాడేటా +### Translation Metadata -అనువదించిన ఫైళ్లకు మెటాదేటా హెడ్డర్ ఉంటుంది: +అనువాద ఫైల్‌లు metadata హెడ్డర్ కలిగి ఉంటాయి: ```markdown ``` -## డీబగ్గింగ్ మరియు సమస్య పరిష్కారం +## Debugging and Troubleshooting -### సాధారణ సమస్యలు +### Common Issues -**క్విజ్ యాప్ ప్రారంభించకపోవడం**: -- Node.js వెర్షన్ చూడండి (v14+ సిఫార్సు) -- `node_modules` మరియు `package-lock.json` తొలగించి `npm install` తిరిగి నడపండి -- పోర్ట్ పోటీని తనిఖీ చేయండి (డిఫాల్ట్: Vite పోర్ట్ 5173 ఉపయోగిస్తుంది) +**క్విజ్ యాప్ మొదలుపెట్టలేకపోతే**: +- Node.js సంస్కరణను తనిఖీ చేయండి (v14+ సిఫార్సు) +- `node_modules` మరియు `package-lock.json` తొలగించి `npm install` మళ్ళీ చేయండి +- పోర్ట్ సంకర్షణలను తనిఖీ చేయండి (డిఫాల్ట్: Vite పోర్ట్ 5173 ఉపయోగిస్తుంది) -**API సర్వర్ ప్రారంభించకపోవడం**: -- Node.js కనీసం (node >=10) వెర్షన్ ఉందనే ధృవీకరించండి -- పోర్ట్ ఇప్పటికే వాడుకలో ఉందో చూడండి -- అన్ని డిపెండెన్సీలు `npm install` తో సరిచూసుకోండి +**API సర్వర్ ప్రారంభం కావడం లేదు**: +- Node.js కనీస సంస్కరణ చూడండి (node >=10) +- పోర్ట్ ఇప్పటికే వాడుకలో ఉందో కాదో తనిఖీ చేయండి +- అన్ని డిపెండెన్సీలు `npm install` తో ఇన్‌స్టాల్ అయ్యాయో చూసుకోండి -**బ్రౌజర్ ఎక్స్టెన్షన్ లోడ్ కానిది**: -- manifest.json సరైన ఫార్మాట్‌లో ఉందా చూడండి -- బ్రౌజర్ కన్సోల్ లో ఎర్రర్స్ తనిఖీ చేయండి -- బ్రౌజర్-ప్రత్యేక ఎక్స్టెన్షన్ ఇన్‌స్టాలేషన్ సూచనలు పాటించండి +**బ్రౌజర్ ఎక్స్‌టెన్షన్ లోడ్ అవడం లేదు**: +- manifest.json సరైన ఫార్మాట్ లో ఉందో చూసుకోండి +- బ్రౌజర్ కన్సోల్ లో ఎర్రర్లు గమనించండి +- బ్రౌజర్ ప్రత్యేక ఎక్స్‌టెన్షన్ ఇన్‌స్టలేషన్ సూచనలను అనుసరించండి **Python చాట్ ప్రాజెక్ట్ సమస్యలు**: -- OpenAI ప్యాకేజీ ఇన్‌స్టాల్ చేసారా: `pip install openai` -- GITHUB_TOKEN ఎన్విరాన్మెంట్ వెరి ఎమ్ ప్ల వేరియబుల్ సెట్ ఐనది తప్పనిసరి -- GitHub మోడల్స్ యాక్సెస్ అనుమతులు సరిచూడండి +- OpenAI ప్యాకేజ్ ఇన్‌స్టాల్ అయ్యి ఉందో చూడండి: `pip install openai` +- GITHUB_TOKEN పరిసర మార్పిడిని సెట్ చేయడం జరిగింది లేదా తనిఖీ చేయండి +- GitHub Models కి యాక్సెస్ అనుమతులు సరిచూడండి **Docsify డాక్స్ అందుబాటులో లేకపోవడం**: -- docsify-cli గ్లోబల్ గా ఇన్‌స్టాల్ చేయండి: `npm install -g docsify-cli` -- రిపాజిటరీ రూట్ డైరెక్టరీ నుంచి రన్ చేయండి -- `docs/_sidebar.md` ఉన్నదో తనిఖీ చేయండి +- docsify-cli ని గ్లోబల్ గా ఇన్‌స్టాల్ చేయండి: `npm install -g docsify-cli` +- కంప్యూటర్‌స్టోర్ రూట్ డైరెక్టరీ నుండి నడపండి +- `docs/_sidebar.md` ఉన్నదో చూడండి -### అభివృద్ధి వాతావరణ సూచనలు +### Development Environment Tips -- HTML ప్రాజెక్టులకి VS Code లో Live Server ఎక్స్టెన్షన్ ఉపయోగించండి -- ESLint మరియు Prettier ఎక్స్టెన్షన్‌లు స్థాపించండి -- JavaScript డీబగ్గింగ్ కోసం బ్రౌజర్ డెవ్ టూల్స్ ఉపయోగించండి -- Vue ప్రాజెక్టులకు Vue DevTools బ్రౌజర్ ఎక్స్టెన్షన్ ఇన్‌స్టాల్ చేయండి +- HTML ప్రాజెక్టులకు VS Code లో Live Server extension ఉపయోగించండి +- నిరంతర ఫార్మాటింగ్ కి ESLint మరియు Prettier extensions ఇన్‌స్టాల్ చేయండి +- JavaScript డీబగ్గింగ్ కోసం బ్రౌజర్ DevTools ఉపయోగించండి +- Vue ప్రాజెక్టుల కోసం Vue DevTools బ్రౌజర్ ఎక్స్‌టెన్షన్ ఇన్‌స్టాల్ చేయండి -### పనితీరు పరిగణనలు +### Performance Considerations -- అనువాదాల సంఖ్య 50+ భాషలతో భారీగా ఉండటం, ఫుల్ క్లోన్ పెద్దదీ అవుతుంది -- కంటెంట్ మీదే పని చేస్తే షాలో క్లోన్ చేయండి: `git clone --depth 1` -- ఇంగ్లీష్ కంటెంట్ పని చేస్తున్నప్పుడు అనువాదాల శోధనను తొలగించండి -- మొదటి సారి రన్ లో (npm install, Vite build) బిల్డ్ ప్రక్రియలు నెమ్మదిగా ఉండవచ్చు +- అనువదించబడిన ఫైళ్ళ సంఖ్య (50+ భాషలు) చాలా ఎక్కువగా ఉండటంతో పూర్తి క్లోన్ భారీగా ఉంటుంది +- కేవలం కంటెంట్ పై పని చేస్తున్నప్పుడు శలో క్లోన్ ఉపయోగించండి: `git clone --depth 1` +- ఆంగ్ల కంటెంట్ పై పని చేస్తున్నప్పుడు అనువాదాలను శోధనలకు అంతర్భాగంగా తీసుకోకూడదు +- మొదటి సారి నడిపే build ప్రక్రియలు నెమ్మదిగా ఉండవచ్చు (npm install, Vite build) -## భద్రతా పరిగణనలు +## Security Considerations -### ఎన్విరాన్మెంట్ వేరియబుల్స్ +### Environment Variables -- API కీలు ఎప్పుడూ రిపాజిటరీలో కమిట్ చేయకూడదు -- `.env` ఫైల్స్ ఉపయోగించండి (.gitignore లో ఉన్నాయి) -- అవసరమైన ఎన్విరాన్మెంట్ వేరియబుల్స్ READMEలలో డాక్యుమెంట్ చేయండి +- API కీలు ఎప్పుడూ కంప్యూటర్‌స్టోర్ లకు కమీట్చేయకూడదు +- `.env` ఫైళ్లను (.gitignore లో ఇప్పటికే ఉన్నాయి) ఉపయోగించండి +- ప్రాజెక్ట్ README లలో అవసరమైన పరిసర మార్పిడులను డాక్యుమెంట్ చేయండి -### Python ప్రాజెక్టులు +### Python Projects -- వర్చువల్ ఎన్విరాన్మెంట్లు ఉపయోగించండి: `python -m venv venv` -- డిపెండెన్సీ లను నూతనీకరించండి -- GitHub టోకన్లు తక్కువ అవసరాల అనుమతులతో ఉండాలి +- వర్చువల్ ఎన్విరాన్‌మెంట్లు ఉపయోగించండి: `python -m venv venv` +- డిపెండెన్సీలు అప్డేట్ గా ఉంచండి +- GitHub టోకెన్లు కనీసం అవసరమయిన అనుమతులతో ఉండాలి -### GitHub మోడల్స్ యాక్సెస్ +### GitHub Models Access -- GitHub మోడల్స్ కోసం వ్యక్తిగత యాక్సెస్ టోకన్లు (PAT) అవసరం -- టోకన్లు ఎన్విరాన్మెంట్ వేరియబుల్స్‌గా నిల్వ చేయండి -- టోకన్లు లేదా క్రెడెన్షియల్స్ ఎప్పుడూ కమిట్ చేయకండి +- GitHub Models కి Personal Access Tokens (PAT) అవసరం +- టోకెన్లను పరిసర మార్పిడులాగా నిల్వ చేయాలి +- టోకెన్లను లేదా క్రెడెన్షియల్స్ ఎప్పుడూ కమీట్ చేయకూడదు -## అదనపు గమనికలు +## Additional Notes -### లక్ష్య సమూహం +### Target Audience -- వెబ్ డెవలప్‌మెంట్ పూర్తిగా ప్రారంభించే వారు -- విద్యార్థులు మరియు స్వయంశిక్షణార్థులు -- తరగతులలో పాఠ్యాంశాన్ని ఉపయోగించే ఉపాధ్యాయులు -- అనుకూలత మరియు ఘనమైన నైపుణ్య నిర్మాణానికి కంటెంట్ రూపకల్పన +- వెబ్ అభివృద్ధి విషయంలో పూర్తి ప్రారంభస్థాయి వ్యక్తులు +- విద్యార్థులు మరియు స్వీయ అభ్యాసకులు +- తరగతుల్లో ఈ పాఠ్యక్రమాన్ని ఉపయోగించే బోధకులు +- కంటెంట్ యాక్సెసిబిలిటీతో మరియు నెమ్మదిగా నైపుణ్యాల నిర్మాణంతో రూపొందించబడింది -### విద్యా తత్వశాస్త్రం +### Educational Philosophy -- ప్రాజెక్ట్ ఆధారిత అధ్యయనం పద్ధతి -- తరచూ జ్ఞాన తనిఖీలు (క్విజ్‌లు) -- చేతితో కోడింగ్ ఆచార్యాలు -- వాస్తవ ప్రపంచ దృష్టాంతాలు -- ఫ్రేమ్‌వర్క్స్ కంటే ముందుగా ప్రాథమిక అంశాలపై దృష్టి +- ప్రాజెక్టు ఆధారిత నేర్చుకోవడం విధానం +- తరచూ జ్ఞాన పరీక్షలు (క్విజ్‌లు) +- చేతితో కోడింగ్ అభ్యాసాలు +- వాస్తవ ప్రపంచ అప్లికేషన్ ఉదాహరణలు +- ఫ్రేమ్‌వర్క్‌ల ముందు ప్రాథమిక అంశాలపై దృష్టి -### రిపాజిటరీ నిర్వహణ +### Repository Maintenance -- Learners మరియు Contributors కమ్యూనిటీ చురుకుగా ఉంది -- Dependencies మరియు కంటెంట్ కు పునర్విమర్శలు -- ఇష్యూస్ మరియు చర్చలు మెంటైనర్లచే పర్యవేక్షణ -- అనువాద నవీకరణలు GitHub Actions తో ఆటోమేటెడ్ +- శ్రద్ధగల అభ్యాసకులు మరియు సహకారుల సమాజం +- డిపెండెన్సీలు మరియు కంటెంట్ యొక్క నియమిత నవీకరణలు +- నిర్వహకులు ఇష్యూస్, చర్చలను పర్యవేక్షిస్తారు +- అనువాద నవీకరణలు ఆటోమేటెడ్ గా GitHub Actions ద్వారా జరుగుతాయి -### సంబంధిత వనరులు +### Related Resources - [Microsoft Learn modules](https://docs.microsoft.com/learn/) - [Student Hub resources](https://docs.microsoft.com/learn/student-hub/) -- వాడేందుకు సిఫార్సు: [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) -- అదనపు కోర్సులు: Generative AI, Data Science, ML, IoT పాఠ్యాంశాలు +- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) అభ్యాసకులకు సిఫార్సు +- అదనపు కోర్సులు: Generative AI, Data Science, ML, IoT పాఠ్యక్రమాలు అందుబాటులో ఉన్నాయి -### నిర్దిష్ట ప్రాజెక్టులతో పని +### Working with Specific Projects -వ్యాఖ్యాత ఫైళ్లలో విస్తృత ప్రమాణాల కోసం చూడండి: +వివిధ ప్రాజెక్టులకు సంబంధించిన వివరాలు README ఫైల్స్ లో ఉన్నాయి: - `quiz-app/README.md` - Vue 3 క్విజ్ అప్లికేషన్ -- `7-bank-project/README.md` - ఆథెంటికేషన్ తో బ్యాంకింగ్ అప్లికేషన్ -- `5-browser-extension/README.md` - బ్రౌజర్ ఎక్స్‌టెన్షన్ డెవలప్‌మెంట్ -- `6-space-game/README.md` - కాన్వాస్ ఆధారిత గేమ్ అభివృద్ధి +- `7-bank-project/README.md` - బ్యాంకింగ్ అప్లికేషన్ తో ఆటెంటికేషన్ +- `5-browser-extension/README.md` - బ్రౌజర్ ఎక్స్‌టెన్షన్ అభివృద్ధి +- `6-space-game/README.md` - క్యాన్వాస్ ఆధారిత ఆట అభివృద్ధి - `9-chat-project/README.md` - AI చాట్ అసిస్టెంట్ ప్రాజెక్ట్ -### మోనోరిపో నిర్మాణం +### Monorepo Structure -ఇది సాంప్రదాయ మోనోరిపో కాదు, కానీ అనేక స్వతంత్ర ప్రాజెక్టులు ఉన్నాయి: -- ప్రతి పాఠం స్వీయ కంటెంట్ కలిగి ఉంటుంది -- ప్రాజెక్టులు డిపెండెన్సీ లను పంచుకోవు -- ఒకదానిపై పని చేయడంవల్ల ఇతరానికి ప్రభావం ఉండదు -- పూర్తి పాఠ్యాంశానికి మొత్తం రిపాజిటరీను క్లోన్ చేయండి +సాంప్రదాయ మోనోరిపో కాకపోయినా, ఈ కంప్యూటర్‌స్టోర్ అనేక స్వతంత్ర ప్రాజెక్టులను కలిగి ఉంది: +- ప్రతి పాఠం స్వతంత్రంగా ఉంటుంది +- ప్రాజెక్టులు డిపెండెన్సీలు పంచుకోవు +- వ్యక్తిగత ప్రాజెక్టులో పని చేయడం వలన ఇతరుల పనికి ప్రభావం ఉండదు +- పూర్తి పాఠ్యక్రమ అనుభవం కోసం మొత్తం రిపోజిటరీను క్లోన్ చేయండి --- -**తెలుపింపు**: -ఈ డాక్యుమెంట్ AI అనువాద సేవ [Co-op Translator](https://github.com/Azure/co-op-translator) ఉపయోగించి అనువదించబడ్డది. మేము ఖచ్చితత్వానికి ప్రయత్నిస్తూన్నప్పటికీ, ఆటోమేటెడ్ అనువాదాల్లో తప్పిదాలు లేదా లోపాలు ఉండవచ్చు. మూల డాక్యుమెంట్ దాని స్వభావ భాషలో అధికారిక మూలంగా పరిగణించవలెను. ముఖ్యమైన సమాచారం కోసం, ప్రొఫెషనల్ మానవ అనువాదాన్ని సిఫారసు చేస్తాము. ఈ అనువాదం ఉపయోగం వల్ల వచ్చే ఏవైనా తప్పుదోవలు లేదా తప్పుదెలుగుల కోసం మేము బాధ్యత తీసుకోనము. +**మరువొచ్చుట (డిస్క్లెయిమర్)**: +ఈ పత్రాన్ని AI అనువాద సేవ అయిన [Co-op Translator](https://github.com/Azure/co-op-translator) ఉపయోగించి అనువదించబడింది. మేము ఖచ్చితత్వానికి యత్నించినప్పటికీ, ఆటోమేటెడ్ అనువాదాలలో తప్పులు లేదా అసత్యతలు ఉండవచ్చు. అసలు పత్రాన్ని దాని స్థానిక భాషలో అధికారిక మూలంగా పరిగణించాలి. ముఖ్యమైన సమాచారం కోసం, వృత్తి సమర్థులైన మానవ అనువాదాన్ని సిఫారసు చేస్తున్నాము. ఈ అనువాదం వాడకం వల్ల కలిగే ఏవైనా అపర్థధారణలు లేదా తప్పుగా అర్థం చేసుకోవడాలకు మేము బాధ్యత వహించము. \ No newline at end of file