Identificați unde vă puteți ajuta

Finalizat

În această unitate, vom discuta cum puteți începe cu contribuțiile open-source. De asemenea, vom utiliza probleme și etichete pentru a găsi activități la care să contribuiți.

software-ul open-source poate fi utilizat liber, modificat și partajat de oricine. Utilizând software-ul open-source, oricine poate vizualiza, modifica și distribui un proiect în orice scop. Ideea din spatele software-ului open-source este că partajarea codului duce la software mai bun, mai fiabil.

Există multe modalități de a contribui la proiecte open-source. Prima contribuție poate fi adesea o experiență înfricoșătoare, dar nu ar trebui să fie. Open Source este un loc pentru toată lumea, iar contribuțiile au loc la toate nivelurile.

Găsiți un proiect open-source care necesită contribuții

Puteți începe gândindu-vă la proiectele pe care le utilizați deja sau doriți să le utilizați. Contribuirea este mai simplă atunci când sunteți familiarizat cu proiectul și comunitatea sa.

Poate în timp ce citiți fișierul README al unui proiect, găsiți un link defect sau câteva greșeli de tastare. Poate că ați observat că ceva nu funcționează așa cum vă așteptați sau documentația este depășită. Acestea sunt toate oportunitățile extraordinare de a ajuta și a contribui la proiect.

Sfat

Un sfat important: Toate tipurile de contribuții sunt valoroase. Nivelul dvs. de experiență sau cunoștințe despre proiect nu contează aici. Toți avem ceva ce putem contribui. Ai încredere în tine. Cel mai important lucru aici este să vă ajute.

De asemenea, puteți utiliza căutarea GitHub pentru a explora subiecte și proiecte asociate. Accesați căutare GitHubși introduceți cuvântul subiectului.

Să presupunem că vă interesează învățarea programată.

Captură de ecran afișând subiectele de căutare GitHub.

Apoi puteți restrânge căutarea selectând Subiecte în bara laterală din stânga.

Captură de ecran care afișează rezultatele unei căutări înguste GitHub.

De acolo puteți găsi depozite relevante pentru cuvântul cheie de căutare și depozitele îngrijite de membrii comunității.

Familiarizați-vă cu un proiect open-source

Ceva ce merită menționat aici este că fiecare comunitate open-source este diferită. După ce ați găsit un proiect, va trebui să vă familiarizați cu proiectul și cu instrucțiunile sale de participare.

Majoritatea proiectelor vor avea aceste documente la nivelul superior al depozitului:

  • LICENȚĂ: Proiectul trebuie să conțină o licență open-source. Dacă proiectul nu are o licență, nu este open source.
  • README: Fișierul README servește de obicei ca pagină de întâmpinare pentru proiect. În general, furnizează informații despre cum să începeți să utilizați proiectul. De asemenea, este comun ca acesta să adauge informații despre modul în care să se implice în comunitate.
  • CONTRIBUIRE: După cum sugerează numele său, acest document oferă instrucțiuni despre cum să contribuiți la proiect. De obicei, descrie modul în care funcționează procesul de contribuție și include detalii despre cum să vă configurați mediul de dezvoltare.
  • CODE_OF_CONDUCT: Codul de conduită stabilește normele de conduită pentru membrii comunității. Procedând astfel, ajută comunitatea să fie un mediu sigur și primitor pentru toți.

Deși nu toate proiectele au DOCUMENTE CONTRIBUITOARE sau CODE_OF_CONDUCT, faptul că aceste documente reprezintă un bun indiciu despre cât de prietenos și de salut este un proiect.

Colaboratorii și întreținetorii open-source provin din întreaga lume. Proiectele au de obicei mai multe canale de comunicare pentru a organiza discuții și a solicita ajutor. O modalitate bună de a vă familiariza cu comunitatea este să citiți prin unele dintre aceste canale de comunicare:

  • Instrument de monitorizare a problemelor: Unde discută oamenii despre probleme și activități legate de proiect. Pentru a găsi problemele din GitHub, puteți să accesați pagina principală a depozitului din GitHub și să adăugați /issues la sfârșitul adresei URL, de exemplu: https://github.com/jupyter/notebook/issues.
  • cerere de tragere: Unde oamenii discută și revizuiesc modificările la proiect. Îl puteți găsi în GitHub adăugând pulls la ADRESA URL a proiectului, de exemplu, https://github.com/jupyter/notebook/pulls.
  • Canale de chat și forumuri: Unele proiecte utilizează canale de chat, cum ar fi Slack, Gitter și IRC sau forumuri precum Discursuri pentru conversații și discuții.

Identificați activitățile la care să lucrați

Ați găsit un proiect, ați citit instrucțiunile privind contribuția și acum sunteți gata să contribuiți.

Poate că ați identificat deja ceva la care să lucrați, cum ar fi remedierea linkurilor întrerupte sau actualizarea documentelor. O modalitate bună de a găsi probleme prietenoase pentru începători cu care să vă ajutați este să vizitați adresa URL a /contribute a proiectului, de exemplu: https://github.com/jupyter/notebook/contribute.

Captură de ecran afișând secțiunea Contribuire la un proiect din GitHub.

Veți observa că majoritatea problemelor afișate în URL-ul contribute vor avea etichete, cum ar fi good-first-issue, help wanted, beginner-friendlyși așa mai departe. Etichetele sunt utilizate adesea pentru a furniza informații de nivel superior despre problemă și tipul de ajutor necesar.

Puteți accesa pagina cu etichete, de exemplu: https://github.com/jupyter/notebook/labels. Apoi selectați problemele care au etichete precum help wanted, discussionsau alte etichete relevante pentru tipul de contribuție în care vă interesează.

Pe măsură ce explorați problemele, este posibil, de asemenea, să observați că există alte probleme sau solicitări de tragere legate.

Captură de ecran care afișează o solicitare de tragere legată de o problemă.

Există multe modalități de a contribui la open source. Puteți sprijini financiar oamenii care construiesc și întrețin ecosistemul open-source prin cod, leadership, mentorat, design și dincolo de acesta.

Open Source se bazează foarte mult pe munca de voluntariat. Sponsorii GitHub vă permit să finanțați proiecte și persoane pentru a-i ajuta să continue să lucreze open-source, oferindu-le în același timp recunoașterea pe care o merită.

Dacă un proiect este eligibil pentru sponsorizare prin Sponsori GitHub, veți găsi un buton Sponsor pe pagina principală a proiectului.

Captură de ecran afișând caseta de sponsorizare pe o pagină de proiect GitHub.

Puteți selecta nivelul sponsorizării și dacă doriți ca contribuția dvs. să fie publică.

Captură de ecran afișând niveluri de sponsorizare.

Recapitulare unitate

În această unitate, ați învățat cum să începeți lucrul cu contribuțiile open-source. Acum știți cum să alegeți un proiect la care să lucrați și cum să utilizați problemele și etichetele GitHub pentru a identifica activitățile la care să lucrați.

Iată o listă de verificare utilă de utilizat atunci când interacționați cu un proiect pentru prima dată:

  • Are o licență?
  • Aveți probleme și trageți discuțiile de solicitare utilizate în mod activ de întreținetori și colaboratori?
  • Proiectul utilizează etichete cum ar fi help wanted sau good first issue pentru nou-veniți?
  • Proiectul are un cod de conduită?
  • Proiectul are instrucțiuni clare privind contribuția?

În sfârșit, rețineți că toate contribuțiile sunt binevenite, iar ecosistemul open-source beneficiază în mare măsură de ideile și participarea dvs. Există multe modalități de a contribui la open source, de la remiterea codului sau implicarea în discuții de proiect la sponsorizarea proiectelor prin sponsorizarea sponsorilor GitHub.