42 KiB

Raw Blame History Unescape Escape

Sissejuhatus GitHubi

Tere, tulevane arendaja! 👋 Oled valmis liituma miljonite kodeerijatega üle kogu maailma? Mul on tõeliselt hea meel tutvustada sulle GitHubi – mõtle sellele kui programmeerijate sotsiaalmeedia platvormile, ainult et selle asemel, et jagada oma lõunasöögi pilte, jagame me koodi ja ehitame koos midagi hämmastavat!

See, mis mulle tõesti meeleheitlikult muljet avaldab: iga rakendus sinu telefonis, iga veebisait, mida sa külastad, ja enamik tööriistu, mida sa õpid kasutama, on ehitatud koos töötavate arendajate tiimide poolt platvormidel nagu GitHub. See muusikarakendus, mida sa armastad? Keegi nagu sina on sellele panuse andnud. See mäng, mida sa ei suuda käest panna? Jep, tõenäoliselt ehitatud GitHubi koostöös. Ja nüüd SA ÕPID, kuidas olla osa sellest imelisest kogukonnast!

Ma tean, et alguses võib see kõik tunduda palju – ausalt öeldes mäletan, kuidas ma esimest korda oma GitHubi lehekülge vaatasin ja mõtlesin „Mida küll see kõik tähendab?“ Aga siin on asi: iga arendaja alustas täpselt sealt, kus sina praegu oled. Selle tunni lõpuks on sul oma GitHubi hoidla (mõtle sellele kui sinu isiklikule projektinäitusele pilves) ja sa tead, kuidas salvestada oma tööd, jagada seda teistega ja isegi panustada projektidesse, mida kasutavad miljonid inimesed.

Me võtame selle teekonna koos – sammhaaval. Ilma kiirustamise ja pingeta – ainult sina, mina ja mõned väga lahedad tööriistad, mis saavad sinu uueks parimaks sõbraks!

Sketchnote autor Tomomi Imura

journey
    title Teie GitHubi seiklus täna
    section Häälestus
      Installi Git: 4: You
      Loo konto: 5: You
      Esimene hoidla: 5: You
    section Git'i valdamine
      Kohalikud muudatused: 4: You
      Commits & Pushes: 5: You
      Harud: 4: You
    section Koostöö
      Fork projekti: 4: You
      Pull requests: 5: You
      Avatud lähtekood: 5: You

Eelsissejuhatuse viktoriin

Sissejuhatus

Enne kui sukeldume kõige põnevamatesse asjadesse, valmistame su arvuti ette GitHubi võluks! Mõtle sellele nagu oma kunstitarvikute korrastamisele enne meistriteose loomist – õige tööriista olemasolu teeb kogu protsessi sujuvamaks ja palju lõbusamaks.

Ma juhatan sind läbi kogu seadistamisprotsessi isiklikult ja luban, et see ei ole üldse nii hirmus, kui esmapilgul tunduda võib. Kui mõni asi kohe ei paista selge olevat, on see täiesti normaalne! Mäletan, kuidas ma seadistasin oma esimest arenduskeskkonda ja tundsin, justkui püüaksin lugeda iidseid hieroglüüfe. Iga arendaja on olnud täpselt seal, kus sina praegu oled, mõtiskledes, kas teeb kõike õigesti. Spoiler: kui sa siin õpid, siis teed seda juba õigesti! 🌟

Selles õppetükis käsitleme:

sinu masina tööl tehtud töö jälgimist
projektide kallal töötamist koos teistega
kuidas panustada avatud lähtekoodiga tarkvarasse

Eeltingimused

Valmistame su arvuti GitHubi võluks ette! Ära muretse – see seadistus tuleb teha ainult korra ja siis oled kogu oma kodeerimisteekonnaks valmis.

Alustame alustalast! Esiteks peame kontrollima, kas Git on su arvutisse juba installitud. Git on põhimõtteliselt nagu väga nutikas assistent, kes mäletab iga sinu koodimuudatust – palju parem kui paaniliselt iga kahe sekundi tagant Ctrl+S vajutada (me kõik oleme seda teinud!).

Kontrollime, kas Git on juba olemas, tippides terminali selle maagilise käsu: git --version

Kui Git veel pole, ära muretse! Mine lihtsalt aadressile download Git ja lae see alla. Kui oled installi lõpetanud, tutvustan sulle Git’i korralikult:

💡 Esimese korraga seadistus: Need käsud ütlevad Git’ile, kes sa oled. See teave lisatakse igale sinu tehtud commit’ile, nii et vali nimi ja e-post, mida oled mugav avalikult jagada.

git config --global user.name "your-name"
git config --global user.email "your-email"

Git’i olemasoleva seadistuse kontrollimiseks võid tippida:

git config --list

Sul on samuti vaja GitHubi kontot, koodiredaktorit (nt Visual Studio Code) ja terminali (või käsurida) avada.

Mine aadressile github.com ja loo konto, kui seda veel pole, või logi sisse ning täida oma profiil.

💡 Kaasaegne näpunäide: Kaalu SSH võtmete seadistamist (SSH keys) või GitHub CLI kasutamist (GitHub CLI) lihtsamaks ja paroolivabaks autentimiseks.

✅ GitHub pole ainus koodipõhine hoidla veebis; on ka teisi, aga GitHub on kõige tuntum.

Ettevalmistus

Sul peab olema nii kohalikust masinast (sülearvuti või lauaarvuti) koodiprojektiga kaust kui avalik hoidla GitHubis, mis on näitena, kuidas panustada teiste projektidesse.

Koodi turvalisuse tagamine

Räägime hetkeks turvalisusest – aga ära muretse, me ei hirmuta sind hullult! Mõtle turvapraktikatele nagu auto või maja lukustamisele. Need on lihtsad harjumused, millest muutuvad su teiseks loomuseks ja hoiavad su raske töö kaitstuna.

Näitan sulle kaasaegseid ja turvalisi viise GitHubiga töötamiseks algusest peale. Nii arendad head harjumused, mis toetavad sind kogu su kodeerimiskarjääri jooksul.

Kui töötad GitHubiga, on oluline järgida turvalisuse parimaid tavasid:

Turvaala	Parim tava	Miks see oluline on
Autentimine	Kasuta SSH võtmeid või isiklikke juurdepääsutokeneid	Paroolid on vähem turvalised ja nende kasutamine väheneb
Kahefaktoriline autentimine	Lülita sisse 2FA oma GitHubi kontol	Lisab täiendava kaitsekihi kontole
Hoidla turvalisus	Ära kunagi tee commit evolventse infot	API võtmed ja paroolid ei tohiks kunagi olla avalikes hoidlates
Sõltuvuste haldus	Lülita sisse Dependabot uuendusteks	Hoiab sinu sõltuvused turvalised ja ajakohased

⚠️ Kriitiline turvameeldetuletus: Ära kunagi tee commit'i API võtmeid, paroole ega muud tundlikku infot mingisse hoidlasse. Kasuta keskkonnamuutujaid ja .gitignore faile tundliku info kaitseks.

Kaasaegne autentimise seadistamine:

# Genereeri SSH võti (kaasaegne ed25519 algoritm)
ssh-keygen -t ed25519 -C "your_email@example.com"

# Sea Git kasutama SSH-d
git remote set-url origin git@github.com:username/repository.git

💡 Profesionaalseks kasutamiseks: SSH võtmed eemaldavad vajaduse mitmel korral paroole sisestada ning on traditsioonilisest autentimisest turvalisemad.

Halda oma koodi nagu proff

Olgu, SEE on see koht, kus asjad tõeliselt põnevaks muutuvad! 🎉 Õpime jälgima ja haldama oma koodi nagu proffid ning ausalt öeldes on see üks mu lemmikuid teemasid õpetada, sest see muudab kõik mängupõhimõtte.

Kujutle, et kirjutad erakordset lugu ning tahad jälgida iga mustandi, iga põneva paranduse ja iga „äh, see on geniaalne!“ hetke teekonda. Täpselt nii teebki Git sinu koodiga! See on nagu imelise ajas rändava märkmiku omamine, mis mäletab KÕIKE – iga klahvivajutust, iga muudatust, iga „ups, nüüd tekkis viga“ hetke, mille saad koheselt tagasi võtta.

Olen aus – see võib alguses tunduda kurnav. Kui ma alustasin, mõtlesin: „Miks ma ei saa lihtsalt oma faile tavapäraselt salvestada?“ Aga usalda mind: kui Git sulle lõpuks klapib (ja see juhtub!), koged „kõrvalmaja valgustuse“ hetke, kus mõtled „Kuidas ma üldse varem ilma selleta koodisin?“ See on nagu avastaksid, et oskad lennata, kuigi kogu elu oled vaid jalutanud!

Oletame, et sul on kohaliku masinaga kaust mõne koodiprojektiga ja soovid hakata oma edusamme jälgima git’i versioonihaldussüsteemi abil. Mõned inimesed võrdlevad git’i kasutamist armastuskirja kirjutamisega oma tulevasele minale. Oma commit’ide kirjade lugemisel päevade, nädalate või kuude pärast tuletad meelde, miks otsuse tegid, või saad „tagasi pöörata“ muudatuse – see tähendab, kui kirjutad head „commit’i sõnumid“.

flowchart TD
    A[📁 Teie Projekti Failid] --> B{Kas see on Git hoidla?}
    B -->|Ei| C[git init]
    B -->|Jah| D[Muuda faile]
    C --> D
    D --> E[git add .]
    E --> F["git commit -m 'sõnum'"]
    F --> G[git push]
    G --> H[🌟 Kood GitHubis!]
    
    H --> I{Tahate koostööd teha?}
    I -->|Jah| J[Tehke fork ja kloonimine]
    I -->|Ei| D
    J --> K[Loo haru]
    K --> L[Muuda faile]
    L --> M[Tee pull taotlus]
    M --> N[🎉 Panustamine!]
    
    style A fill:#fff59d
    style H fill:#c8e6c9
    style N fill:#ff4081,color:#fff

Ülesanne: loo oma esimene hoidla!

🎯 Sinu missioon (ja ma olen nii elevil sinu pärast!): Loome sinu esimese GitHubi hoidla koos! Selle lõpus on sul oma väike nurk internetis, kus elab sinu kood, ning oled teinud oma esimese „commit’i“ (see tähendab arendajakeeles, et oled oma töö salvestanud väga nutikalt).

See on tõeliselt eriline hetk – oled ametlikult liitumas arendajate maailmakogukonnaga! Ma mäletan siiani, kuidas ehmatasin, kui tegin oma esimese repo ja mõtlesin: „Vau, ma tõesti teen seda!“

Käime selle seikluse samm-sammult läbi. Võta iga osa jaoks aega – kiirustamiseks pole auhinda ja luban, et iga samm saab lõpuks selgeks. Pea meeles, iga kodeerimise superstaar, keda imetled, istus kunagi seal, kus sina oled, just enne oma esimest hoidlat looma hakkamist. Kui äge see on?

Vaata videot

Teeme selle koos:

Loo oma hoidla GitHubis. Mine GitHub.com ja otsi seda heledat rohelist New nuppu (või paremas ülanurgas olevat + märki). Kliki sellel ja vali New repository.

Tee nii:
1. Anna oma hoidlale nimi – vali midagi tähenduslikku!
2. Lisa kirjeldus, kui soovid (see aitab teistel mõista, millega su projekt tegeleb)
3. Otsusta, kas teha see avalik (kõik näevad) või privaatne (ainult sinu jaoks)
4. Soovitan märkida linnuke kastikesse README faili lisamiseks – see on nagu projekti esileht
5. Kliki Create repository ja tähista – just lõid oma esimese repo! 🎉
Mine oma projekti kausta. Nüüd ava terminal (ära karda, see ei ole üldse nii hirmus nagu tundub!). Peame ütlema arvutile, kus su projektifailid asuvad. Tippige see käsk:
```
cd [name of your folder]
```
Mida me siin teeme:
- Ütleme arvutile „Hei, vii mind minu projektikausta“
- See on nagu konkreetse kausta avamine oma töölaual, aga me teeme seda tekstikäsklustega
- Asenda [name of your folder] oma tegeliku projektikausta nimega
Muuda oma kaust Git’i hoidla'ks. Siin juhtub võlu! Tippige:
```
git init
```
Mis just juhtus (päris lahe, eks?):
- Git lõi su projektikausta sees peidetud .git kausta – sa ei näe seda, aga see on olemas!
- Sinu tavaline kaust on nüüd „hoidla“, mis suudab jälgida kõiki tehtud muudatusi
- Mõtle sellele nagu annaksid oma kaustale supervõimed kõike mäletada
Vaata, mis toimub. Vaatame, mida Git praegu su projekti kohta arvab:
```
git status
```
Mida Git sulle ütleb:

Võid näha midagi sellist:
```
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git restore <file>..." to discard changes in working directory)

     modified:   file.txt
     modified:   file2.txt
```
Ära paanitse! See tähendab nii:
- Failid punases värvis on muudatused, mis pole veel valmis salvestamiseks
- Failid rohelises värvis (kui neid näed) on valmis salvestamiseks
- Git aitab sul, öeldes täpselt, mida järgmiseks teha
💡 Professionaalne nipp: käsk git status on su parim sõber! Kasuta seda iga kord, kui olukord tundub segane. See on nagu küsiks Git’ilt „Hei, mis seis on praegu?“
Valmista failid salvestamiseks ette (see on „staging“ ehk lisamine alale):
```
git add .
```
Mida me just tegime:
- Ütlesime Gatile „Hei, tahan järgmisesse salvestusse lisada KÕIK oma failid“
- . tähendab „kõik selles kaustas“
- Nüüd on failid „lavale seatud“ ja valmis järgmiseks sammuks
Tahan olla valivam? Võid lisada ka vaid kindlad failid:
```
git add [file or folder name]
```
Miks sa seda teha võid?
- Mõnikord tahad seotud muudatused koos salvestada
- See aitab sul oma tööd loogilistesse osadesse korraldada
- Muudab hiljem lihtsamaks aru saada, mis ja millal muutus
Mõtlesid ümber? Pole probleemi! Võid failid „lavalt“ maha võtta nii:
```
# Kõik muudatused valikust eemaldada
git reset

# Eemalda valikust ainult üks fail
git reset [file name]
```
Ära muretse – see ei kustuta sinu tööd, lihtsalt võtab failid „valmis salvestamiseks“ hunnikust välja.
Salvesta töö püsivalt (tehes oma esimese commit’i!):
```
git commit -m "first commit"
```
🎉 Palju õnne! Sa tegid oma esimese commit’i!

Mis just juhtus:
- Git tegi kõigist lavale seatud failidest just selle hetke „hetktõmmise“
- Sinu commit’i sõnum „first commit“ selgitab, miks see salvestuspunkt tehti
- Git andis sellele hetktõmmisele unikaalse ID, et saaksid seda alati hiljem leida
- Sa alustasid ametlikult oma projekti ajaloo jälgimist!
💡 Tulevaste commit’i sõnumite jaoks: Ole järgmistel kordadel kirjalikum! „Updated stuff“ asemel proovi „Lisa kontaktivorm avalehele“ või „Paranda navigeerimismenüü viga“. Su tulevane mina tänab sind!
Ühenda oma kohalik projekt GitHubiga. Praegu asub su projekt vaid arvutis. Ühendame selle sinu GitHubi hoidlaga, et saaksid seda maailmaga jagada!

Kõigepealt mine oma GitHubi hoidla lehele ja kopeeri seal oleva hoidla URL. Siis tule siia tagasi ja tipi:
```
git remote add origin https://github.com/username/repository_name.git
```
(Asenda see URL oma hoidla tegeliku URL-iga!)

Mida me just tegime:
- Me lõime ühenduse teie kohaliku projekti ja teie GitHubi hoidla vahel
- "Origin" on lihtsalt hüüdnimi teie GitHubi hoidla jaoks – see on nagu kontakti lisamine telefoni
- Nüüd teab teie kohalik Git kuhu teie koodi saata, kui olete valmis seda jagama
💡 Lihtsam viis: Kui teil on GitHub CLI paigaldatud, saate seda teha ühe käsuga:
```
gh repo create my-repo --public --push --source=.
```
Saatke oma kood GitHubi (suur hetk!):
```
git push -u origin main
```
🚀 See ongi see! Te laadite oma koodi GitHubi üles!

Mis toimub:
- Teie commit'id liiguvad teie arvutist GitHubi
- -u lipp seab üles püsiva ühenduse, et tulevased push-d oleksid lihtsamad
- "main" on teie põhiharude nimi (nagu peamine kaust)
- Pärast seda saate lihtsalt kasutada git push tulevaste üleslaadimiste jaoks!
💡 Kiire märkus: Kui teie haru nimi on midagi muud (näiteks "master"), kasutage seda nime. Saate kontrollida käsuga git branch --show-current.
Teie uus igapäevane kodeerimise rütm (siin muutub see sõltuvust tekitavaks!):

Edaspidi, igal korral, kui teie projektis muudatusi teete, on teil see lihtne kolmetapiline tants:
```
git add .
git commit -m "describe what you changed"
git push
```
See muutub teie kodeerimise südametukseks:
- Tehke oma koodis lahedaid muudatusi ✨
- Lisage need git add-ga ("Hei Git, pööra neile muudatustele tähelepanu!")
- Salvestage need git commit-iga koos kirjeldava sõnumiga (tulevane teie tänab teid!)
- Jagage neid maailmaga git push-iga 🚀
- Korda ja korda – tõesti, see muutub sama loomulikuks kui hingamine!
Mulle meeldib see töövoog, sest see on nagu mängus mitme salvestuspunkti omamine. Tegite muudatuse, mis teile meeldib? Commit'i see! Tahate proovida midagi riskantset? Pole probleemi – alati saate tagasi minna oma viimase commit’i juurde, kui asjad lähevad vintsi!

💡 Vihje: Võiksite ka lisada .gitignore faili, et takistada failide, mida te ei taha jälgida, ilmumist GitHubi – nagu see märkmikufail, mida hoiate samas kaustas, kuid millel pole kohta avalikus hoidlas. .gitignore failide malle leiate aadressilt .gitignore templates või saate ühe luua aadressil gitignore.io.

🧠 Esimene hoidla üleslaadimine: Kuidas see end tundus?

Võtke hetk tähistamiseks ja reflekteerimiseks:

Kuidas tundus näha oma koodi esimest korda GitHubis?
Milline samm tundus kõige segasem ja milline üllatavalt lihtne?
Kas saate oma sõnadega seletada vahet git add, git commit ja git push vahel?

stateDiagram-v2
    [*] --> LocalFiles: Loo projekt
    LocalFiles --> Staged: git add .
    Staged --> Committed: git commit
    Committed --> GitHub: git push
    GitHub --> [*]: Edu! 🎉
    
    note right of Staged
        Failid valmis salvestamiseks
    end note
    
    note right of Committed
        Hetkeseis tehtud
    end note

Mäleta: Isegi kogenud arendajad kipuvad mõnikord täpseid käske unustama. Selle töövoo lihasmäluks muutmine nõuab harjutamist – teil läheb suurepäraselt!

Kaasaegsed Git’i töövood

Kaaluge nende kaasaegsete tavade omaksvõttu:

Tavapärased commit’id: Kasutage standardiseeritud commit sõnumite vormingut nagu feat:, fix:, docs: jne. Lisateavet leiate aadressilt conventionalcommits.org
Atomilised commit’id: Iga commit peaks esindama üht konkreetset muutust
Sagedased commit’id: Commiti sageli koos kirjeldavate sõnumitega, mitte harva ja suuri kogumeid

Commit sõnumid

Hea Git commit'i teemareal lõpetatakse järgnev lause: Kui rakendatud, teeb see commit

Teema puhul kasutage imperatiivi olevikus: "muuda", mitte "muutnud" ega "muudab". Nii nagu teemareas, kasutage ka (vabatahtlikus) kirjelduses imperatiivi olevikus. Kirjeldus peaks sisaldama muutuse motivatsiooni ja võrdlust varasema käitumisega. Selgitate „miks“, mitte „kuidas“.

✅ Võtke paar minutit GitHubis ringi sirvimiseks. Kas leiate tõeliselt hea commit sõnumi? Kas leiate väga minimaalse sõnumi? Milline info on commit sõnumis teie arvates kõige olulisem ja kasulikum?

Töötamine koos teistega (Lõbus osa!)

Hoidke mütsi, sest SIIN muutub GitHub tõeliselt maagiliseks! 🪄 Olete juba oma koodi haldamise selgeks saanud, aga nüüd sukeldume minu absoluutse lemmiku juurde – koostöösse hämmastavate inimestega üle kogu maailma.

Kujutage ette: ärkate homme ja näete, et keegi Tokyos parandas teie koodi, kui te magasite. Siis keegi Berlinis parandab vea, kus teil oli takerdumine. Pealelõunaks on Sao Paulos arendaja lisanud funktsiooni, millest te isegi mõelnud ei olnud. See pole ulme – see on lihtsalt teisipäev GitHubi universumis!

Mis mind tõeliselt elevile paneb, on see, et koostööoskused, mida teie hakkate õppima? Need on TÄPSELT samad töövood, mida Google, Microsoft ja teie lemmikud idufirmad iga päev kasutavad. Te ei õpi lihtsalt lahedat tööriista – te õpite saladuskeelt, mis paneb kogu tarkvaramaailma koos töötama.

Tõsiselt, kui kogete esimest korda seda emotsiooni, kui keegi ühineb teie esimese pull request’iga, mõistate, miks arendajad on avatud lähtekoodiga nii kirglikud. See on nagu osa maailma suurimast ja loovamast meeskonnaprojektist!

Vaadake videot

Peamine põhjus, miks asju GitHubi panna, oli võimaldada koostööd teiste arendajatega.

flowchart LR
    A[🔍 Leia Projekt] --> B[🍴 Hargne Repositoorium]
    B --> C[📥 Kloneeri Kohalikku]
    C --> D[🌿 Loo Haru]
    D --> E[✏️ Tee Muudatused]
    E --> F[💾 Tee Kinnitus]
    F --> G[📤 Lükka Haru]
    G --> H[🔄 Loo Tõmbepäring]
    H --> I{Hooldaja Ülevaade}
    I -->|✅ Kinnitatud| J[🎉 Ühenda!]
    I -->|❓ Muudatusi Palutud| K[📝 Tee Uuendused]
    K --> F
    J --> L[🧹 Puhasta Harud]
    
    style A fill:#e3f2fd
    style J fill:#e8f5e8
    style L fill:#fff3e0

Mine oma hoidlas Insights > Community, et näha, kuidas teie projekt vastab soovitatud kogukonna standarditele.

Tahate, et teie hoidla näeks välja professionaalne ja sõbralik? Mine oma hoidla juurde ja klõpsa Insights > Community. See lahe funktsioon näitab, kuidas teie projekt võrdub sellega, mida GitHubi kogukond peab heaks hoidlapraktikaks.

🎯 Projekti särama panemine: Hästi organiseeritud hoidla hea dokumentatsiooniga on nagu puhas ja sõbralik pood. See ütleb inimestele, et hoolite oma tööst ja muudab teised kinnisideed panustama!

Sellised asjad teevad hoidla suurepäraseks:

Mida lisada	Miks see oluline on	Mida see teile teeb
Kirjeldus	Esimene mulje loeb!	Inimesed teavad kohe, mida teie projekt teeb
README	Teie projekti esileht	Nii nagu sõbralik giid uutele külastajatele
Panustamise juhised	Näitab, et olete abi vastu avatud	Inimesed teavad täpselt, kuidas aidata
Käitumisreeglid	Loob sõbraliku ruumi	Kõik tunnevad end oodatuna osalema
Litsents	Õiguslik selgus	Teised teavad, kuidas nad saavad teie koodi kasutada
Turvapoliitika	Näitab, et olete vastutustundlik	Demonstreerib professionaalseid tavasid

💡 Proffide nipp: GitHub pakub nende failide jaoks malle. Uue hoidla loomisel valige kastid, et need failid automaatselt genereerida.

Kaasaegsed GitHubi funktsioonid, mida uurida:

🤖 Automatiseerimine & CI/CD:

GitHub Actions automatiseeritud testimiseks ja juurutamiseks
Dependabot automaatsete sõltuvuste uuenduste jaoks

💬 Kogukond & Projekti haldamine:

GitHub Discussions kogukonna vestlused probleemide kõrval
GitHub Projects kanban-tüüpi projektihaldus
Haru kaitse reeglid koodikvaliteedi standardite tagamiseks

Kõik need ressursid aitavad uutel meeskonnaliikmetel kiiremini sisse elada. Ja need on tavaliselt esimesed asjad, mida uued panustajad vaatavad enne koodi uurimist, et otsustada, kas projekt on neile õige koht aja veetmiseks.

✅ README failid, kuigi vajavad aega ettevalmistamiseks, jäävad sageli hõivatud hooldajate poolt tähelepanuta. Kas saate leida eriti kirjeldava näite? Märkus: on olemas mõningaid tööriistu head README loomise abistamiseks, mida võiksite proovida.

Ülesanne: Mõne koodi ühendamine

Panustamise dokumentatsioon aitab inimestel projektile panustada. See seletab, millist tüüpi panuseid te otsite ja kuidas protsess toimib. Panustajad peavad läbima rea samme, et saada võimalust teie hoidla GitHubis panustada:

Teie hoidla forkimine. Tõenäoliselt tahate, et inimesed forkiksid teie projekti. Forkkimine tähendab teie hoidla koopia loomist nende GitHubi profiilil.
Kloonimine. Sealt kopeerivad nad projekti oma kohalikule masinale.
Haru loomine. Tahtsite, et nad looksid oma töö jaoks hooldanud haru.
Muudatuse keskendumine ühele alale. Paluge panustajatel keskenduda oma panused korraga ühele asjale – nii on suurem võimalus, et saate nende töö ühendada. Kujutage ette, et nad kirjutavad vigade paranduse, lisavad uue funktsiooni ja uuendavad mitmeid teste – mis siis, kui soovite või saate rakendada ainult 2-st 3-st või 1-st 3-st muudatusest?

✅ Kujutage ette olukorda, kus harud on eriti olulised hea koodi kirjutamiseks ja saatmiseks. Milliseid kasutusjuhtumeid saate välja tuua?

Märkus, olge ise muutus, mida soovite maailmas näha, ja tehke teretulnud harud ka oma töö jaoks. Kõik commit’id tehakse sellel harul, millel parasjagu “oled”. Vaadake, millisel harul te olete käsuga git status.

Läheme läbi panustaja töövoo. Eeldame, et panustaja on juba oma hoidla forkinud ja klooninud, nii et tal on kohalik Git hoidla kasutamiseks valmis:

Haru loomine. Kasutage käsku git branch, et luua haru, kuhu panustaja lisatud muudatused mahuvad:
```
git branch [branch-name]
```
💡 Kaasaegne lähenemine: Samuti saate ühe käsuga uue haru luua ja sellele üle lülituda:
```
git switch -c [branch-name]
```
Vahetage tööharrule. Vahetage antud harule ja uuendage töökataloogi käsuga git switch:
```
git switch [branch-name]
```
💡 Kaasaegne märkus: git switch on kaasaegne asendus käsule git checkout harude vahetamiseks. See on algajatele selgem ja turvalisem.
Töötage. Nüüd lisage oma muudatused. Ärge unustage Gitile sellest teada anda järgmiste käskudega:
```
git add .
git commit -m "my changes"
```
⚠️ Commit sõnumi kvaliteet: Kindlasti andke oma commit’ile hea nimi nii enda kui hoidla hooldaja jaoks, kellele aitate. Olge täpne, mida muutsite!
Ühendage oma töö main haruga. Ühel hetkel olete tööga valmis ja tahate liita oma töö main haruga. Kuna main haru võis vahepeal muutuda, veenduge esmalt, et see on kõige värskem järgmiste käskude abil:
```
git switch main
git pull
```
Siin veendute, et kõik konfliktid – olukorrad, kus Git ei saa muutusi lihtsalt ühendada, tekivad teie tööharrul. Käivitage seetõttu järgmised käsud:
```
git switch [branch_name]
git merge main
```
Käsk git merge main toob kõik main haru muudatused teie harusse. Loodetavasti saate edasi minna. Kui mitte, ütleb VS Code, kus Git on segaduses, ning teie muudetud failid selgitavad, milline sisu on õige.

💡 Kaasaegne alternatiiv: Mõelge git rebase kasutamisele puhtama ajaloo jaoks:
```
git rebase main
```
See mängib teie commit’id viimase main haru peale, luues lineaarselt ajaloo.
Saada oma töö GitHubi. Töölaua saatmine GitHubi tähendab kahte asja. Saadate oma haru oma hoidlas üles ja seejärel avate PR-i ehk Pull Request’i.
```
git push --set-upstream origin [branch-name]
```
Ülaltoodud käsk loob haru teie forkitud hoidlas.

🤝 Koostööoskuste kontroll: Kas oled valmis teistega töötama?

Vaatame, kuidas sa koostöö suhtes end tunned:

Kas idee forkimisest ja pull request’idest on nüüd arusaadav?
Mis on üks asi harudega töötamise juures, mida soovite rohkem harjutada?
Kui mugavalt tunnete end kellegi teise projektile panustades?

mindmap
  root((Git Koostöö))
    Branching
      Funktsiooniharud
      Vigade parandamise harud
      Eksperimentaalne töö
    Pull Requests
      Koodi ülevaatus
      Arutelu
      Testimine
    Best Practices
      Selged commit-sõnumid
      Väikesed keskendunud muudatused
      Hea dokumentatsioon

Kindlustunne: Igaüks arendajatest, keda imetlete, oli kord närvis oma esimese pull requesti üle. GitHubi kogukond on uustulnukatele väga vastuvõtlik!

Ava PR. Järgmisena avate PR'i. Teete seda, minnes GitHubis oma forkitud hoidla juurde. Saate märguande, kus küsitakse, kas soovite luua uue PR’i. Klõpsate ja viiakse teieni kasutajaliides, kus saate muuta commit sõnumi pealkirja, anda sobivama kirjelduse. Nüüd näeb hoidla hooldaja seda PR’i ja pöidlad pihku, nad hindavad ja liidavad teie PR’i. Olete nüüd panustaja, juubeldage :)

💡 Kaasaegne nipp: Võite ka GitHub CLI abil PR-e luua:
```
gh pr create --title "Your PR title" --body "Description of changes"
```
🔧 Parimad tavad PR-ide jaoks:
- Lisage seotud probleemide lingid märksõnadega nagu "Fixes #123"
- Lisage UI muudatuste ekraanipildid
- Paluge konkreetseid ülevaatajaid
- Kasutage kavandi PR-e töö käigus
- Veenduge, et kõik CI kontrollid on läbitud enne ülevaate taotlemist
Puhastamine. Peetakse heaks tavaks puhastada pärast õnnestunud PR-i ühendamist. Soovite puhastada nii oma kohaliku haru kui haru, mille GitHubi üles laadisite. Kõigepealt kustutame selle kohalikult järgmise käsuga:
```
git branch -d [branch-name]
```
Veenduge, et lähete järgmiseks GitHubi lehele selle forkitud repos ja eemaldate just sinna üles laaditud kaugharud.

Pull request tundub rumal termin, sest tegelikult soovite oma muudatusi projektile üles laadida. Kuid hooldaja (projekti omanik) või tuumikmeeskond peab teie muudatused enne projekti "main" harusse ühendamist üle vaatama, seega taotlete tegelikult otsust muudatuse kohta hooldajalt.

Pull request on koht, kus saab harude vahelist erinevust võrdlevalt arutada läbi ülevaadete, kommentaaride, integreeritud testide ja muu. Hea pull request järgib ligikaudu samu reegleid nagu commit-sõnum. Võite lisada viite probleemile probleemide jälgimissüsteemis, kui teie töö näiteks lahendab mõne probleemi. Seda tehakse #-märgi ja teie probleemi numbri abil. Näiteks #97.

🤞Pöidlad pihku, et kõik kontrollid läheksid läbi ja projektipidajad ühendaksid teie muudatused projekti🤞

Uuendage oma praegust kohalikku töötavat haru kõigi uute commitidega vastavast GitHubi kaugharust:

git pull

Panustamine avatud lähtekoodiga (teie võimalus avaldada mõju!)

Kas olete valmis millekski, mis teie mõistuse päris pahviks lööb? 🤯 Räägime panustamisest avatud lähtekoodi projektidesse – ja mul tekib juba kananahk, kui mõtlen, et saan seda teiega jagada!

See on teie võimalus saada osaks millestki tõeliselt erakordsest. Kujutage ette, et parandate tööriistu, mida kasutavad miljonid arendajad iga päev, või parandate vea rakenduses, mida teie sõbrad armastavad. See pole mitte ainult unistus – see ongi avatud lähtekoodiga panustamise olemus!

Kõik see tekitab mul külmavärinaid iga kord, kui sellele mõtlen: iga tööriist, millega olete õppinud – teie koodiredaktor, raamistikud, mida uurime, isegi brauser, milles seda loete – algas kellegi nagu teie esimesest panusest. See geniaalne arendaja, kes ehitas teie lemmik VS Code'i laienduse? Ka nemad olid kord algajad, kes värisevate kätega klõpsasid "create pull request", just nagu teie ees ootab.

Ja siin on kõige ilusam osa: avatud lähtekoodi kogukond on nagu interneti suurim grupp-sõlmimine. Enamik projekte otsib aktiivselt uusi inimesi ja on kutsunud probleeme siltidega "good first issue" just teile! Hooldajad on tõeliselt põnevil, kui näevad uusi panustajaid, sest nad mäletavad oma esimesi samme.

flowchart TD
    A[🔍 Uuri GitHubi] --> B[🏷️ Leia "hea esimene probleem"]
    B --> C[📖 Loe panustamise juhiseid]
    C --> D[🍴 Forki hoidla]
    D --> E[💻 Sea üles kohalik keskkond]
    E --> F[🌿 Loo funktsiooniharu]
    F --> G[✨ Tee oma panus]
    G --> H[🧪 Testi oma muudatusi]
    H --> I[📝 Kirjuta selge commit]
    I --> J[📤 Pushi & loo PR]
    J --> K[💬 Suhtle tagasisidega]
    K --> L[🎉 Ühendatud! Sa oled panustaja!]
    L --> M[🌟 Leia järgmine probleem]
    
    style A fill:#e1f5fe
    style L fill:#c8e6c9
    style M fill:#fff59d

Te ei õpi siin lihtsalt kodeerima – te valmistute liitumiseks ülemaailmse ehitajate perega, kes ärkab iga päev mõttega "Kuidas saaksime digitaalmaailma veidi paremaks muuta?" Tere tulemast klubisse! 🌟

Esmalt leidke GitHubist endale huvipakkuv hoidlasse (või repo), kuhu sooviksite panustada. Soovite selle sisu oma masinasse kopeerida.

✅ Hea viis "algajasõbralike" hoidlate leidmiseks on otsida silti 'good-first-issue'.

Koodi kopeerimiseks on mitu võimalust. Üks neist on 'kloneerida' hoidla sisu HTTPS-i, SSH-ga või GitHub CLI (käsklusrida) abil.

Avage terminal ja kloneerige hoidla järgmiselt:

# HTTPS-i kasutamine
git clone https://github.com/ProjectURL

# SSH kasutamine (nõuab SSH võtme seadistamist)
git clone git@github.com:username/repository.git

# GitHub CLI kasutamine
gh repo clone username/repository

Projekti kallal töötamiseks minge õigele kaustale: cd ProjectURL

Võite avada kogu projekti ka järgmiste võimalustega:

GitHub Codespaces - GitHubi pilve-arenduskeskkond VS Code brauseris
GitHub Desktop - GUI rakendus Git käskude jaoks
GitHub.dev - Vajutage suvalises GitHubi hoidlas klahvi . VS Code'i avamiseks brauseris
VS Code GitHub Pull Requests laiendusega

Lõpuks võite koodi alla laadida ka tihendatud kaustana.

Mõned lisahuvitavad faktid GitHubi kohta

Saate GitHubis tähti panna, jälgida ja/või "forkida" mis tahes avalikku hoidlat. Oma tähistatud hoidlaid leiate üleval parempoolse rippmenüü alt. See on nagu järjehoidja, aga koodi jaoks.

Projektidel on probleemide jälgimise süsteem, enamasti GitHubis vahekaardil "Issues", kui pole märgitud teisiti, kus arutletakse projekti küsimuste üle. Ja Pull Requests vahekaart on koht, kus arutatakse ja vaadatakse muudatusi, mis on töös.

Projektidel võivad olla ka arutelud foorumites, meililistides või vestluskanalites nagu Slack, Discord või IRC.

🔧 Tänapäevased GitHubi funktsioonid:

GitHub Discussions - Kogukonna vestluste integreeritud foorum
GitHub Sponsors - Toetage hooldajaid rahaliselt
Security tab - Haavatavusaruanded ja turvakonsultatsioonid
Actions tab - Vaadake automatiseeritud töövooge ja CI/CD torujuhtmeid
Insights tab - Analüütika panustajate, commitide ja projekti tervise kohta
Projects tab - GitHubi sisseehitatud projektijuhtimisvahendid

✅ Vaadake üle oma uus GitHubi hoidla ja proovige mõnda asja, näiteks seadistuste muutmist, info lisamist hoidlasse, projekti loomist (nt Kanban tahvel) ja GitHub Actionsi seadistamist automatiseerimiseks. Võimalusi on palju!

🚀 Väljakutse

Olgu, on aeg panna teie säravad uued GitHubi supervõimed proovile! 🚀 Siin on väljakutse, mis paneb kõik klõpsama kõige rahuldustpakkuvamal viisil:

Võtke sõber (või see pereliige, kes alati küsib, millega te kõik need "arvutiasjad" tegelete) ja asuge koos koostöös kodeerima! Just siin sünnib tõeline võlu – looge projekt, laske neil see forkida, tehke harud ja ühendage muudatused nagu juba professionaalid, kelleks saate.

Ma ei valeta – tõenäoliselt naerate mingil hetkel (eriti siis, kui proovite mõlemad sama rida muuta), võib-olla ajate pead segaduses, aga kindlasti kogete neid hämmastavaid "aha!"-hetki, mis kõik õppetöö hästi ära tasuvad. Pealegi on midagi erilist esimest edukat ühendamist kellegagi jagada – see on nagu väike tähistamine, kui kaugele olete jõudnud!

Kas teil veel koodikaaslast pole? Pole probleemi! GitHubi kogukond on täis uskumatult sõbralikke inimesi, kes mäletavad, milline tunne on olla uus. Otsige hoidlaid märgistega "good first issue" – need kutsuvad algajaid õppima! Kui äge see on?

Loengu järel test

Ülevaade & Jätka õppimist

Huh! 🎉 Vaadake ise – olete just GitHubi põhialused vallutanud nagu tõeline meister! Kui teie pea tundub praegu natuke täis olevat, on see täiesti normaalne ja ausalt ka hea märk. Olete just õppinud tööriistu, mis mul võtsid nädalaid, enne kui end nendega mugavalt tundsin.

Git ja GitHub on uskumatult võimsad (tõsiselt võimsad) ning iga arendaja, keda ma tunnen – ka need, kes nüüd näivad olevat nagu võlurid – pidid harjutama ja vahel eksima, enne kui kõik klõpsas. See, et olete selle õppetüki läbinud, tähendab, et olete juba teel vallutama mõnda arendajate kõige olulisemat tööriista.

Siin on mõned tõeliselt suurepärased ressursid harjutamiseks ja veelgi võimsamaks muutumiseks:

Juhend panustamiseks avatud lähtekoodi tarkvarasse – Teie teejuht mõju avaldamiseks
Git kiirjuhend – Hoidke see käepärast kiireks viitamiseks!

Ja pidage meeles: harjutamine teeb edenemise, mitte täiuslikkuse! Mida rohkem kasutate Git-i ja GitHubi, seda loomulikumaks see muutub. GitHub on loonud mõnusaid interaktiivseid kursuseid, kus saate turvalises keskkonnas harjutada:

Tunnete end seikluslikuna? Vaadake neid kaasaegseid tööriistu:

GitHub CLI dokumentatsioon – Kui tahate tunda end käsurea võlurina
GitHub Codespaces dokumentatsioon – Kodeerige pilves!
GitHub Actions dokumentatsioon – Automatiseerige kõik asjad
Git parimad praktikad – Tõstke oma töövoog järgmisele tasemele

GitHub Copiloti agendi väljakutse 🚀

Kasutage Agent režiimi järgmise väljakutse täitmiseks:

Kirjeldus: Looge koostöine veebiarendusprojekt, mis demonstreerib kogu selles õppetükis õppitud GitHubi töövoogu. See väljakutse aitab teil harjutada hoidla loomist, koostöö funktsioone ja kaasaegseid Git töövooge reaalses situatsioonis.

Üleskutse: Looge uus avalik GitHubi hoidla lihtsa "Veebiarenduse Ressursid" projekti jaoks. Hoidla peaks sisaldama hästi struktureeritud README.md faili kasulike veebiarenduse tööriistade ja ressursside nimekirjaga, kategoriseeritult (HTML, CSS, JavaScript jne). Seadistage hoidla vastavalt kogukonna standarditele, sealhulgas litsents, panustamise juhised ja käitumiskoodeks. Looge vähemalt kaks funktsiooniharud: üks CSS ressursside lisamiseks ja teine JavaScripti ressursside jaoks. Tehke kummaski harus commit-id kirjeldavate sõnumitega, seejärel looge pull requestid muudatuste ühendamiseks peaharusse. Lülitage sisse GitHubi funktsioonid nagu Issues, Discussions ja seadistage lihtne GitHub Actions töövoog automatiseeritud kontrollide jaoks.

Ülesanne

Teie missioon, kui otsustate selle vastu võtta: lõpetage Sissejuhatus GitHubi kursus GitHub Skills'is. See interaktiivne kursus laseb teil turvalises, juhendatud keskkonnas harjutada kõike, mida olete õppinud. Pealegi saate lõpetamisel laheda märgise! 🏅

Tunnete end valmis rohkemaks?

Seadistage SSH autentimine oma GitHubi kontol (paroolid jäävad minevikku!)
Proovige kasutada GitHub CLI oma päevastes Git toimingutes
Looge hoidla GitHub Actions töövooga
Avage see hoidla pilvepõhises redaktoris läbi GitHub Codespaces

🚀 Teie GitHubi meistriklassi ajakava

⚡ Mida saate teha järgmise 5 minutiga

Pange tähis sellele hoidlaile ja veel 3-le huvipakkuvale projektile
Seadistage oma GitHubi kontole kaksikautentimine
Looge lihtne README oma esimese hoidla jaoks
Jälgige 5 arendajat, kelle töö teid inspireerib

🎯 Mida saate selle tunni jooksul saavutada

Täitke loengu järel test ja mõtisklege oma GitHubi teekonna üle
Seadistage SSH võtmepaar GitHubi paroolivabaks autentimiseks
Tehke oma esimene tähendusrikas commit hea sõnumiga
Avastage GitHubi "Explore" vahekaart, et leida trendiprojekte
Harjutage hoidla forkimist ja väikse muudatuse tegemist

📅 Teie nädalane GitHubi seiklus

Lõpetage GitHub Skills kursused (Sissejuhatus GitHubi, Markdown)
Tehke oma esimene pull request avatud lähtekoodi projekti
Looge GitHub Pages sait, et näidata oma töid
Liituge GitHub Discussions aruteludega huvipakkuvatel projektidel
Looge hoidla vastavalt kogukonna standarditele (README, litsents jms)
Proovige GitHub Codespaces pilvepõhist arendust

🌟 Teie kuu pikkune muutumine

Panustage 3 erinevasse avatud lähtekoodi projekti
Mentorige kedagi uut GitHubis (tagasiandmine!)
Seadistage automatiseeritud töövood GitHub Actionsiga
Koostage portfoolio, mis näitab teie GitHubi panuseid
Osalege Hacktoberfestil või sarnastel kogukonnaüritustel
Saage oma projekti hooldajaks, kuhu teised on panustanud

🎓 Lõplik GitHubi meisterlikkuse ülevaatus

Tähistage, kui kaugele olete jõudnud:

Mis on teie lemmik asi GitHubi kasutamisel?
Milline koostööfunktsioon paneb teid kõige rohkem põnevusest õhkama?
Kui enesekindlalt tunnete end nüüd, panustades avatud lähtekoodi?
Millise esimese projekti soovite panustada?

journey
    title Sinu GitHubi Enesekindluse Teekond
    section Täna
      Närviline: 3: You
      Uudishimulik: 4: You
      Elevil: 5: You
    section See Nädal
      Harjutamine: 4: You
      Panustamine: 5: You
      Ühendamine: 5: You
    section Järgmine Kuu
      Koostöö: 5: You
      Juhtimine: 5: You
      Teisi Inspireeriv: 5: You

🌍 Tere tulemast globaalsesse arendajate kogukonda! Teil on nüüd tööriistad, et teha koostööd miljonite arendajatega üle maailma. Teie esimene panus võib tunduda väike, kuid pidage meeles – iga suur avatud lähtekoodiga projekt algas kellegi esimesest commit-ist. Küsimus pole selles, kas avaldate mõju, vaid milline vinge projekt saab teie ainulaadsest perspektiivist esmalt kasu! 🚀

Pidage meeles: iga ekspert oli kord algaja. Te saate hakkama! 💪

Vastutusest loobumine: See dokument on tõlgitud tehisintellekti tõlketeenuse Co-op Translator abil. Kuigi me püüdleme täpsuse poole, palun arvestage, et automatiseeritud tõlked võivad sisaldada vigu või ebatäpsusi. Algne dokument selle emakeeles on otsustavaks allikaks. Olulise teabe puhul soovitatakse kasutada professionaalset inimtõlget. Me ei vastuta selle tõlke kasutamisest tulenevate arusaamatuste või valesti mõistmiste eest.

42 KiB Raw Blame History Unescape Escape