lucasvbr/first-contributions

Fork 0

mirror of https://github.com/LucasVbr/first-contributions.git synced 2026-05-13 17:21:50 +00:00

Files

T

Roshanjossey b166a1d130 reset repo

2025-01-03 22:30:04 +01:00

7.4 KiB

Raw Permalink Blame History

Unuaj Kontribuoj

Estas malfacile. Iam estas malfacile la unua fojo kiam vi faras ion, speciale kiam vi kunlaboras kun aliaj, ĉar fari erarojn ne estas agrable. Nia celo estas simpligi la manieron en kiu novaj kontribuantoj de malferma kodo lernas kaj kontribuas unue.

Legi artikolojn kaj rigardi tutoriaojn povas helpi, sed kio estas pli bona ol fari aferojn en praktika medio? Ĉi tiu projekto celas esti gvidilo kaj simpligi la manieron en kiu komencantoj faras sian unuan kontribuon. Se vi volas fari vian unuan kontribuon, sekvu la paŝojn kiuj estas montritaj sube.

Se vi ne estas konata kun la komandlinio, jen tutoriaj uzante ilojn kun Grafika Interfaco (GUI)

Se vi ne havas git-on en via komputilo, vi povas trovi instrukciojn por instali ĝin ĉi tie.

Forku (Fork) ĉi tiun deponejon

Forku ĉi tiun deponejon klakante la butonon "Fork" en la supraj dekstra flanko de ĉi tiu paĝo. Tio kreos kopion de ĉi tiu deponejo en via konto.

Klono (Clone) la forkan deponejon

Nun klono ĉi tiun deponejon al via komputilo. Iru al via GitHub-konto, klaku sur la butono "clone or download" kaj poste klaku sur la ikono por kopii al la poŝtelefono.

Malfermu vian konsolon aŭ terminalon kaj rulu la jenan git-an komandon:

git clone "url you just copied"

Kie estas "la URL kiun vi ĵus kopis" (sen la duobla cita signo) estas la URL de ĉi tiu deponejo (via fork de ĉi tiu projekto). Rigardu la antaŭajn paŝojn por akiri la URL-on.

Ekzemple:

git clone git@github.com:this-is-you/first-contributions.git

La parto kun este-eres-tu estos anstataŭigita per via GitHub-uzantonomo. Ĉi tie vi kopias la enhavon de la deponejo first-contributions de GitHub al via komputilo.

Krei branĉon (Branch)

Shanĝu al la dosierujo de la deponejo sur via komputilo (se vi ne jam estas tie):

cd first-contributions

Nun kredu branĉon (branch) uzante la komandon git checkout:

git switch -c your-new-branch-name

Ekzemple:

git switch -c add-alonzo-church

(La nomo de la branĉo ne devas enhavi la vorton add, sed estas racionebla ĉar la celo de tiu ĉi branĉo estas aldoni vian nomon al la listo.)

Faru la necesajn ŝanĝojn kaj konfirmu (Commit) tiujn ŝanĝojn

Malfermu la dosieron Contributors.md en teksta redaktilo kaj aldonu vian nomon. Ne aldonu ĝin aŭ en la komenco aŭ en la fino de la dosiero, sed faru tion ie interne. Konservu la dosieron.

Se vi iras al la projekta dosierujo kaj ekzekutas la komandon git status, vi vidos ke estas ŝanĝoj.

Aldonu tiujn ŝanĝojn al la branĉo kiun vi kreis antaŭe uzante la komandon git add:

git add Contributors.md

Nun konfirmu tiujn ŝanĝojn uzante la komandon git commit:

git commit -m "Aldonu <via-nomo> al la listo de Kontribuantoj"

anstataŭigu <via-nomo> per via nomo.

Puŝu (Push) viajn ŝanĝojn al GitHub

Puŝu viajn ŝanĝojn uzante la komandon git push:

git push -u origin your-branch-name

Anstataŭigu <aldonu-la-nomon-de-la-branĉo> per la nomo de la branĉo kiun vi kreis antaŭe.

Submetu (Submit) viajn ŝanĝojn por revizio

Se vi iras al via deponejo en GitHub, vi vidos butonon Compare & pull request. Klaku sur tiu butono.

Nun sendu la pull request.

Baldaŭ mi unuos viajn ŝanĝojn (faros merge) kun la ĉefa branĉo de tiu ĉi projekto. Vi ricevos retmesaĝon kiam la ŝanĝoj estos unuitaj.

Kie iri de ĉi tie?

Gratulojn! Vi ĵus finis la regulan fork -> clone -> redaktu -> pull request fluon kiun vi ofte renkontos kiel kontribuanto!

Festu vian kontribuon kaj dividiĝu kun viaj amikoj kaj sekvantoj irante al rete apikaĵo.

Vi ankaŭ povas aliĝi al nia Slack-teamo se vi bezonas helpon aŭ havas demandojn. Aliĝu al nia Slack-teamo.

Nun komencu kontribui al aliaj projektoj. Ni kolektis liston de projektoj kun facilaj problemoj, por ke vi povu ekhavi. Rigardu la liston de projektoj en la rete apikaĵo.