Cum de a organiza cooperarea pe GitHub, programare web

Dacă încă nu știu, GitHub este un mod foarte eficient de a colabora la proiecte.

Cum mă pot alătura dezvoltarea proiectului? Cred că știi cum să folosești Git. pentru a face modificări la fișierele și a le transfera la server. Dar sunt avantajele de a lua parte la dezvoltarea unor proiecte mari open source, și GitHub cu siguranta cel mai bun loc pentru a face acest lucru.

În acest articol, vom discuta unele dintre regulile de funcționare a unor astfel de proiecte, precum și a da cunoștințele necesare și instrucțiuni pentru începători.

Start mici

Pornind de lucru pe un proiect open source, este important să se definească rolul său. De fapt, oamenii de multe ori refuză să participe la dezvoltarea doar pentru că se tem să nu par prea programatori cu experiență și cunoștințe.

Nu-ți fie teamă să înceapă mici. în loc de a încerca să stabilească mai multe erori (bug-uri) sau pentru a suprascrie un modul, încercați să găsiți defecte în documentația și cross-platform de bug-uri, sau chiar sintaxă simplă și erori gramaticale (de exemplu, pe GitHub mzgol de utilizator).

Aceste sarcini sunt o modalitate foarte bună de a lua primii pași ca unul care a avut o mână în dezvoltarea oricărui proiect, și nu ia în sarcina descurajatoare. Înscrie-te pentru resurse CodeTriage. pentru a primi în mod automat Probleme github în căsuța poștală.

Examinați ecosistemul proiectului

În orice colaborare, de regulă, a introdus un set de acorduri. Printre acestea pot fi modificările metodei, programul sau chiar standardele sintactice și regulile de formatare. Înainte de a începe lucrul efectiv la proiect, citiți toată documentația disponibilă.

De exemplu, GitHub standardizata fișier CONTRIBUTING.md (de exemplu, se referă la acest document). Aceste instrucțiuni sunt susținute de oameni care servesc codebase.

Acum, că sunt parte a ecosistemului proiectului, cum face cu adevărat o diferență?

Utilizarea Pull-Cerere de modificare

Mediul de operare pentru a face modificări ale codului, poate părea la prima descurajantă.

Primul lucru pe care ar trebui să înțeleagă este importanța respectării standardelor și convențiilor ale proiectului la care lucrezi (așa cum sa discutat mai sus). mediu de operare standard pe GitHub este destul de simplu și vă permite să:

În mediul de lucru, puteți vedea o mulțime de diferențe între diferitele proiecte. De exemplu, diferențele în acordurile privind titlul. Unele proiecte pot utiliza tip bug_345 de acord. unde 345 este un identificator (ID #) problemă GitHub.

Unele proiecte folosesc mesajul scurt, cu corecturi, și altele - mai mult decât lung. Ceea ce urmează este un ghid pas cu pas, care va ajuta la a face cu interfață și funcționalitate.

Etapa 1: Branch (bifurcare)

O ramură a magaziei de pe GitHub.com

Pasul 2: Clonarea

Pasul 3: Adăugarea la distanță Upstream

Efectuați modificări în folderul clonat și apoi puteți adăuga la distanță în amonte. că este, specificați un depozit la distanță, care va fi fuziunea editărilor locale:

Acum puteți face modificări la nivel local și le puteți sincroniza cu un depozit la distanță:

Pasul 4: Selectați ramura (Subiect Branch)

Înainte de a face modificări, selectați o ramură:

Pasul 5: Crearea editările

Acum, puteți face modificări și de a crea o comite, care va urmări doar aceste modificări:

Pasul 6: Adăugarea editări

Apoi, trebuie să facă modificări aduse sucursalei proiectului dumneavoastră:

Pasul 7: Crearea unei Request'a Pull

În cele din urmă, puteți crea o cerere de tragere. Pentru a face acest lucru, du-te la depozitul filialei. Acolo veți vedea cuvintele „schimbat recent filialei» (crengi recent împinse), și dacă da, puteți alege „Comparați și să facă o cerere Trageți» (Comparați și Pull Cerere).

În caz contrar, puteți alege sucursala dvs. din lista verticală și faceți clic pe «Pull Cerere» sau «Comparați» din partea dreapta sus a secțiunii Repository.

Creați cerere de tragere prin intermediul butonului «Compara si Pull Cerere».

Creați cerere de tragere prin intermediul listei drop-down de sucursale

Rețineți că este important să existe respectarea administratorilor de proiect. În cazul în care modificările nu au fost acceptate, aceasta înseamnă că administratorii de fapt există un motiv bun. În final, puteți ramifica întotdeauna de proiect și de a face modificările.

Cum de a scrie un angajat Github Zach Holman (Zach Holman) în documentul «Cum GitHub Utilizeaza GitHub pentru a construi GitHub», trage cerere această discuție. Este în acest sens că acestea ar trebui să fie luate; în loc să aștepte decizia instantanee a editările dvs., ar trebui să așteptați discuția ei.

GitHub Probleme + Cereri Pull = management de proiect Zen

Disponibil la instrumentul GitHub Probleme github, care oferă o modalitate sigură de a crea un bine documentat, interactiv discuții, automatizat de bug-uri și caracteristici ale oricărui proiect. Probleme incluse în mod implicit, dar o puteți dezactiva.

Probleme au multe mari built-in caracteristici, dar unul dintre cele mai importante este integrarea cu tragere request'ami. Utilizatorul se poate referi la problema în dvs. comite, doar adăugând la ID-ul său digital.

Aceasta comite va emite marca în mod automat №3 ca închisă, atunci când cererea de tragere corespunzătoare vor fi acceptate. Această metodă permite automatizarea GitHub un instrument excelent pentru gestionarea procesului de dezvoltare.

Căutați alte modalități de a interacționa

De multe ori, proiectele mari open-source au avantajul de a lucra împreună cu ei peste câțiva oameni.

Nu fi induși în eroare să creadă că singura modalitate de a contribui la proiect este utilizarea de tragere request'ov.

De exemplu, un proiect ca Ruby on Rails. El a fost cunoscut pentru comunitatea sa; a răspuns la întrebările din forumuri și IRC-chat-urile, pentru a ajuta la creșterea gradului de conștientizare a acestui cadru, și de a ajuta la dezvoltarea sa ghideze prin discutarea ideilor și erorile constatate.

Totul depinde de atitudinea

Amintiți-vă că proiectele open source sunt conduse de oameni pentru care multiplicarea și difuzarea cunoștințelor este cel mai important. Participarea la astfel de proiecte vor fi mai eficiente dacă aveți o atitudine corectă, al cărei sens se află în următoarea întrebare: „Cum te pot ajuta? „Ceea ce diferă de relația,“ voi ajuta cum pot. "

Oamenii din lumea open source, doresc să lucreze cu cei care sunt conduse de dorința de a ajuta pe alții.

concluzie

Dacă sunteți interesat în dezvoltarea de proiecte open-source, atunci este bine! Dacă decideți să participați la unul dintre ele, atunci nu uita atitudinea corectă și principiul „începe mici“. Acest lucru vă va aduce la punctul în care vedeți numele în noul atașat la request'e proiect trage.

Este posibil ca acest cod va fi folosit de mulți oameni din întreaga lume, în activitatea lor de zi cu zi. Ia timp pentru a studia proiectul și oamenii care participă la ea. Fii sincer în încercarea de a contribui la dezvoltarea proiectului.

potențial GitHub și lumea open-source continuă să crească în fiecare zi; Începe să coopereze cu alți dezvoltatori și să fie o parte din această lume!

Traducerea articolului «Cum să colaborați la GitHub» a fost pregătit de o echipă de proiect prietenos Web design de la A la Z.