Hacktoberfest este o sărbătoare anuală de o lună a proiectelor open-source, menținătorilor și colaboratorilor. Evenimentul își propune să promoveze open source și să încurajeze dezvoltatorii să contribuie.

Hacktoberfest vine cu stimulente pentru primii 40.000 de participanți care primesc patru cereri de extragere fuzionate până pe 31 octombrie. Poți să faci fie să plantezi un copac în numele tău, fie un tricou Hacktoberfest.

Totul începe cu prima ta cerere de extragere/combinare.

Înregistrarea la Hacktoberfest

Pentru a participa la Hacktoberfest, trebuie mai întâi să vă înregistrați la eveniment pe hacktoberfest.com.

Veți vedea un ecran similar cu acesta:

Trebuie să aveți un cont GitHub sau GitLab pentru a participa.

Alegeți serviciul de găzduire preferat și faceți clic pe INIŢIA buton. Făcând clic pe acest buton, veți fi redirecționat către aplicația aleasă, care vă va cere să aprobați Hacktoberfest.

Autorizarea Hacktoberfest vă va înregistra automat pentru eveniment.

Găsirea proiectelor la care să contribui pe GitHub și GitLab

Numai contribuțiile la proiectele open-source participante pe GitHub sau GitLab va conta pentru Hacktoberfest. Trebuie să aveți un cont GitHub sau GitLab pentru a participa.

GitHub

Pentru a găsi proiecte care participă la Hacktoberfest pe GitHub:

  1. Navigheaza catre github.com.
  2. Navigați la bara de căutare de pe GitHub sau apăsați tasta bară oblică (/) pe tastatură.
  3. Tastați „Hacktoberfest” și faceți clic pe INTRODUCE buton.

Urmând pașii de mai sus, se vor afișa mai multe rezultate, cu subiectul Hacktoberfest în partea de sus. Acest subiect vă va oferi o listă de depozite la care puteți contribui, așa cum se arată în imaginea de mai jos.

Alternativ, puteți merge direct la GitHub Hacktoberfest subiect.

GitLab

Pentru a găsi proiecte care participă la Hacktoberfest pe GitLab:

  1. Navigheaza catre gitlab.com.
  2. Pe pagina de pornire, selectați explora proiecte publice.
  3. Pe pagina de explorare a proiectelor, selectați explora subiecte.
  4. În filtrează după căutare câmp, introduceți „Hacktoberfest”.

Urmând pașii de mai sus, se vor afișa mai multe rezultate, cu subiectul Hacktoberfest ca primul. Acest subiect vă va oferi o listă de depozite la care puteți contribui, așa cum se arată în imaginea de mai jos.

Alternativ, puteți merge direct la GitLab Hacktoberfest subiect.

Crearea unei cereri de tragere (PR) pe GitHub

O cerere de extragere (PR) este o propunere făcută de un colaborator la un proiect prin care îi cere întreținătorului proiectului să revizuiască și să îmbine modificările propuse la proiect.

Pentru a face un PR, trebuie să găsiți un proiect Hacktoberfest la care doriți să contribuiți. După ce găsiți un proiect, faceți clic pe furculiţă butonul din colțul din dreapta sus:

Bifurcarea unui proiect creează o copie a proiectului în contul GitHub, permițându-vă să faceți modificări fără a afecta proiectul principal. După ce ați accesat proiectul, clonați depozitul din contul dvs. și faceți modificările în mediul dvs. de dezvoltare local.

Asigurați-vă că citiți regulile de contribuție ale proiectului și urmați-le pentru a crește șansele de solicitare de atracție.

După ce ați făcut modificările și ați adăugat versiunea bifurcată a depozitului, comite modificările folosind Gitși împingeți-le în GitHub.

Când modificările se reflectă pe GitHub, veți primi un prompt care vă informează că furk-ul este „commit” înaintea ramurii principale, așa cum se arată în imaginea de mai jos.

Apoi, faceți clic pe a contribui butonul din prompt. Făcând clic pe acest buton, vă va solicita să deschideți o cerere de extragere, așa cum se arată în imaginea de mai jos.

Apoi, faceți clic pe cerere de tragere deschisă buton. Aceasta vă va duce la o pagină în care veți examina regulile de contribuție și un titlu și descriere pentru cererea dvs. de extragere.

Completați câmpurile obligatorii și faceți clic pe Creați cerere de tragere butonul, așa cum se arată în imaginea de mai jos.

Ați creat o cerere de extragere. Acum, așteptați ca întreținătorii proiectului să revizuiască și să fuzioneze sau să vă respingă contribuția.

Crearea unei cereri de fuzionare pe GitLab

O solicitare de îmbinare este identică cu o cerere de extragere. Singura diferență este numele lor respective.

Pentru a face o cerere de fuziune, trebuie mai întâi să găsiți un proiect Hacktoberfest la care doriți să contribuiți. Odată ce găsiți un proiect, faceți clic pe butonul furculiță din colțul din dreapta sus:

Bifurcarea unui proiect creează o copie a proiectului în contul dvs. GitLab, permițându-vă să faceți modificări fără a afecta proiectul principal. După ce ați accesat proiectul, clonați depozitul din contul dvs. și faceți modificările în mediul dvs. de dezvoltare local.

Asigurați-vă că citiți regulile de contribuție ale proiectului și urmați-le pentru a crește șansele de solicitare de atracție.

După ce ați făcut modificările și ați adăugat versiunea bifurcată a depozitului, efectuați modificările și împingeți-le în GitLab.

După ce ați introdus modificările în GitLab, navigați la proiectul dvs. bifurcat și faceți clic Solicitări de îmbinare în bara laterală. Aceasta va afișa un ecran care explică o solicitare de îmbinare și a Solicitare nouă de îmbinare buton. Apasă pe Solicitare nouă de îmbinare butonul, așa cum se arată în imaginea de mai jos.

În continuare, va trebui să selectați a sursă și ţintă ramură. The sursă ramura ar trebui să fie ramura în care se află modificările pe care doriți să le efectuați în depozitul principal. The ţintă ramura ar trebui să fie depozitul principal în care doriți să efectuați modificările. După selectarea ramurilor, faceți clic pe Comparați ramurile și continuați butonul, așa cum se arată în imaginea de mai jos.

Făcând clic pe Comparați ramurile și continuați butonul vă va duce la o pagină în care puteți introduce un titlu și o descriere pentru cererea dvs. de îmbinare.

Completați detaliile necesare și faceți clic pe Creați butonul de solicitare de îmbinare, așa cum se arată în imaginea de mai jos.

Făcând clic pe acest buton, se creează cererea de îmbinare. Acum trebuie să așteptați ca întreținătorii proiectului să revizuiască și să fuzioneze sau să închidă cererea dvs. de extragere.

Termenii și condițiile Hacktoberfest

Toate contribuțiile făcute la proiectele Hacktoberfest trebuie să fie în limitele Hacktoberfest și să nu fie spam. Nerespectarea regulilor Hacktoberfest poate atrage descalificarea de la eveniment.

Hacktoberfest emite o perioadă de examinare de șapte zile pentru solicitările de extragere/combinare care urmează toate instrucțiunile. Dacă PR-ul tău este bun, proiectul ar trebui să îl accepte pentru Hacktoberfest în acest interval de timp.

Contribuție fericită!