Kā sākt ieguldīt atvērtā koda projektā
Nebaidies piedalīties. Šis raksts parāda, kā izvēlēties pirmo projektu, uzrakstīt pull request un kļūt par noderīgu komandas dalībnieku.
Kāpēc atvērtais kods ir tik svarīgs?
Atvērtā koda pasaule nav tikai par programmēšanu. It's par kopienas spēku, dalīšanos un kopīgu mācīšanos. Kad jūs piedalāties atvērtā koda projektā, jūs kļūstat daļu no kaut kas daudz lielāka — tīkla, kurā izstrādātāji no visas pasaules strādā kopā, lai izveidotu rīkus, ko lieto miljardi cilvēku.
Latvijas tehnoloģiju kopiena piedalās šajā globālajā kustībā. Mūsu valsts izstrādātāji veicina nozīmīgus projektus, skaita atsilipi un padara tehnoloģiju pasauli atvērtāku. Un jūs varat arī.
Pirmie soļi: kā uzsākt
Piedalīšanās atvērtā koda projektā nav tik grūti, cik var šķist. Seko šiem soļiem, un tu būsi ceļā uz pirmo ieguldījumu.
01
Atrodiet projektu, kas tevi interesē
Nepieciešams sākt ar kaut ko, kas tevi tiešām ieinteresē. Vai tas ir web framework, mājsaimniecības rīks vai datu analīzes bibliotēka — piedalīšanās ir vieglāka, ja tevi patiešām saista šis projekts. GitHub, GitLab un SourceForge ir lieliski sākumpunkti. Meklējiet projektus, kuriem ir "good first issue" žetoni vai "beginner-friendly" apzīmējumi.
02
Izpētiet dokumentāciju un kopienu
Pirms koda rakstīšanas, pārlasi README failu un contributing vadlīnijas. Šie dokumenti izskaidro, kā projektā ieguldīt. Apskati arī issues un diskusijas — redzēsi, kādi jautājumi cilvēkus satrauc. Dažreiz vienkāršu dokumentācijas labojumu vai testa rakstīšana ir ideāls sākums. You'll understand the project's rhythm much faster this way.
03
Lokāli uzstādiet projektu
Fork repository un klonējiet to uz savu datoru. Izpildiet setup instrukcijas — parasti tas nozīmē dažu komandu palaišanu termināļa. Don't worry if something breaks — tas ir normāli. Projekta vadības sistēma (parasti Git) ļaus jums eksperimentēt bez risku. Vairumā projektu jāinstalē atkarības un jāpalaiž testi.
04
Piedariniet izmaiņas un testējiet
Sāciet ar mazu labojumu. Var būt bug fixes, dokumentācijas uzlabojumi vai jauni testi. Kad esat piedarinājis kodu, palaidu projektā pieejamos testus. Pārliecināties, ka jūsu izmaiņas neiznīcina esošo funkcionalitāti. Tas ir svarīgi. Un commit messages jāraksta skaidri — "Fixed typo in README" ir labāk nekā "fix".
05
Iesniedziet pull request
Push savu branch uz forked repository un izveidojiet pull request pret original projektu. Rakstiet skaidru aprakstu — kāds bija problēma un kā jūs to atrisinājāt. Projekta maintainers skatīsies jūsu kodu, un viņi var jautāt par izmaiņām. Don't take feedback personally — tas ir konstruktīvs process. Iespējams, jums lūgs nedaudz mainīt, un tas ir pavisam normāli.
Praktiskos padomus, kas palīdz
Daži ieteikumi, kas padarīs jūsu ieguldījumu vērtīgāku un pieredzi patīkamāku.
Sāciet ar mazu
Neraizējaties par liela ieguldījuma izdarīšanu. Sākt ar vienu dokumentācijas labojumu vai vienu jaunu testu ir lieliski. Tas iemāca projektā darboties un parāda jūsu nodomi.
Komunicējiet skaidri
Labi rakstīts commit message un pull request apraksts ir puse no darba. Skaidra komunikācija palīdz maintainers saprast jūsu nolūku un jūsu kodu.
Lasiet kodu
Viena no labākajām lietām ir vienkārši lasīt citu kodu. You'll learn patterns, see different approaches, and understand how experienced developers think. It's like studying.
Respektējiet kopienu
Atvērtā koda kopiena darbojas uz pielaidības un savstarpējās cieņas pamata. Esi laipni, pieņem kritiku un skaidi atbildi uz jautājumiem. Negatīvums tikai skaida projektu.
Skat arī, kas tika atspīļots
Skatieties uz pull requests, kurus noraidīja vai ar kuriem mainīja. Tā jūs mācīsities, kā pieņemt atsauksmes un uzlabot savu darbu nākamajā reizē.
Instrumenti, ko jums vajadzēs
Laba ziņa — vairums atvērtā koda piedalīšanai nepieciešamo rīku ir pilnīgi bezmaksas. Un tāpēc tie parasti ir open source.
Git
Versiju kontroles sistēma, ko lieto gandrīz visi projekti. Iemācieties pamatkomandas — clone, commit, push, pull. Git ir jūsu draugs, nevis ienaidnieks. Once you get it, you'll wonder how you ever coded without it.
GitHub vai GitLab
Platformas, kurā hostēti atvērtā koda projekti. GitHub ir lielākā, bet GitLab bieži ir izvēle privātām komandam. Tur jūs atrastat projektus, iesniegzat pull requests un sazinaties ar citiem izstrādātājiem.
Teksta redaktors vai IDE
Visual Studio Code, Vim, Sublime — izvēlieties, kas jums patīk. Lielākajai daļai iesācēju VS Code ir ideāls — tā ir mācīšanās un atvērtā koda draudzīga. Bez maksas, ar lieliskiem paplašinājumiem.
Terminal vai Command Line
Jūs daudz laika pavadīsiet termināļa logā. Don't be scared of it — tas ir jūsu jaunais labākais draugs. Tā jūs palaidsiet testus, iesniegzat kodu un komunicējat ar Git.
Ar ko jūs varētu saskarties
Jāpasaka taisnība — ne vienmēr ir viegli. Bet šīs problēmas ir atrisināmas, un tās ir normālas.
Dokumentācija ir nepilnīga
Dažreiz setup instrukcijas ir neskaidras vai neatjauninātas. Jautājiet! Atvērtā koda kopiena ir tur, lai palīdzētu. Atvēra issue vai pieprasi Discord kanālā. Iespējams, jūs varētu arī labot dokumentāciju pēc tam.
Mainers ir aizņemti
Lielā daļa atvērtā koda vadītāju darbojas brīvprātīgi. Atbildes var aizņemt nedēļas. Don't take it personally. Patience is part of open source. Vienlaikus, daži projekti ir ļoti reaktīvi.
Jūsu kods tiek noraidīts
Tas notiek ikvienam. Mainiet to, un mēģiniet vēlreiz. Dažreiz ir jūsu kods, dažreiz ir, ka projekts vienkārši nav piemērots jūsu idejai. Nav nekas beidzams — vienmēr ir cits projekts.
Bīstams koda stils
Katram projektam ir savs koda stils. Linters un formatters palīdz. Seko projekta vadlīnijām, un tu būsi labi. Tas ir tikai skaistuma jautājums, nevis loģika.
Latvijas atvērtā koda kopiena
Latvijas tech kopiena piedalās globālajā atvērtā koda kustībā. Mūsu valsts izstrādātāji veicina nozīmīgus projektus un aktīvi palīdz jaunajiem ieguldītājiem. It's a welcoming place to start your open source journey.
Meklējiet lokālas meetup grupas, Linux Latvija forumu un tech konferences. Tur jūs satiktu citus izstrādātājus, kuri strādā ar atvērto kodu. Tīkla veidošana ir tik svarīga, cik pats kods. Un Latvijas kopiena ir ļoti draudzīga — iesācējiem.
Jūsu ceļš sākas šodien
Atvērtā koda pasaule ir gaida jūs. Nav nepieciešams būt super programmētājam, lai sāktu piedalīties. Dokumentācijas labojumi, testi, kļūdu paziņojumi — tie visi ir noderīgi ieguldījumi. Start small, learn continuously, and don't worry about being perfect. The open source community values effort and willingness to learn above all else.
Izvēlieties projektu, kas jums interesē, un uzsāciet. Jūsu pirmā pull request var būt nedaudz baidoša, bet tā ir arī viena no labākajām sajūtām programmēšanā — redzēt savu kodu, kas pieņemts un iekļauts projektā, ko lieto citi cilvēki.
Saistītie raksti
Informācija par šo rakstu
Šis raksts ir informatīvs materiāls, kas paredzēts jūsu izpratnei par atvērtā koda ieguldījumiem. Konkrētās procedūras, projekti un rīki var atšķirties atkarībā no projekta un laika. Vienmēr izlasiet projekta contributing vadlīnijas un dokumentāciju pirms ieguldījuma. Šajā rakstā ietvertā informācija ir balstīta uz vispārējiem open source principiem, un tā ir derīga mācību nolūkos.