Bidrar effektivt til Open Source-prosjekter Webmaker

Hva du skal skape

Å bidra til åpen kildekodeprosjekt har mange fordeler. Mens du bidrar til et slikt prosjekt, lærer du den profesjonelle utviklingsmåten som distribueres av store organisasjoner. Slike ferdigheter viser seg å være svært nyttige for folks karrierer og hjelpe dem til å lære ting de kanskje ikke kan lære under utdanning / arbeid.

Denne artikkelen er designet for nybegynnere og mellomliggende utviklere som ønsker å bidra til åpen kildekodeprosjekt. Jeg vil demonstrere å bidra til Webmaker-prosjektet i Mozilla Foundation, for å forklare hvordan du effektivt kan bidra til åpen kildekodeprosjekt.

Case Study: Mozilla Webmaker

Vi vil gå gjennom hele prosessen med å bli involvert i et prosjekt, fra å forstå retningslinjene for å bidra, bruke en GitHub-konto og bruke Git til å bruke Bugzilla effektivt. Denne opplæringen vil demonstrere hvordan du kan få patchene slått sammen i hovedkoden for et prosjekt. Jeg skal bruke eksemplet på en gammel og enkel feil som jeg løst, da jeg nettopp hadde startet åpen kildekode-bidrag.

Først av alt må du finne prosjektregisteret. For eksempel vil vi jobbe på Profil komponent av webmaker.

https://github.com/mozilla/webmaker-profile-2

Logg inn på din GitHub-konto, og Gaffel prosjektet. Etter at du har gjort det, vil du ha forked-depotet under ditt brukernavn.

For eksempel hadde jeg følgende:

https://github.com/tanay1337/webmaker-profile-2

Du må ha Git installert på systemet ditt. Du kan lese retningslinjene for hvordan du gjør det.

På nederste høyre side vil du legge merke til en boks som dette:

Du kan kopiere den nettadressen for å klone oppbevaringen i systemet. Kjør nå Git i kommandolinjemodus og skriv inn følgende kommando.

git klon https://github.com/tanay1337/webmaker-profile-2.git

Dette vil importere all koden til systemet ditt under en navngitt mappe WebMaker-profil-2-. Bidragende retningslinjer er vanligvis til stede i en fil som heter CONTRIBUTING.md og installasjonsinstruksjonene er i README.md. Les disse to dokumentene nøye. De inneholder viktig informasjon for utviklere.

Skriv inn Bugzilla!

Nå må du finne noen relevante og enkle feil for å begynne med. For eventuelle Mozilla relaterte prosjekter kan du bruke Bugs Ahoy for å finne gode første bugs samt mentored bugs som er spesifikke for ditt ferdighetssett. Mozilla bruker Bugzilla for feilsøking og administrasjon, samt håndtering av funksjonsforespørsler. Du kan logge inn på Bugzilla ved hjelp av Persona. Når du finner en relevant feil, bør du kommentere den feilen som viser din interesse for å fikse feilen.

Du kan også be om hjelp til å finne en bestemt fil i kildekoden der feilen er tilstede fra utviklerne på Mozillas IRC. De er en veldig vennlig gruppe mennesker som vil hjelpe deg med å løse din første feil. Hvis ingen er online, kan du prøve å legge til en needinfoflagg for mentoren nevnt i feilen, og han vil komme tilbake for å hjelpe deg!

Lagrer endringer i lokalregisteret

Nå, forutsatt at du har løst feilen og gjort de respektive endringene i filene lokalt, må du se filene som er endret lokalt ved hjelp av versjonskontrollsystemet. Skriv bare følgende kommando i WebMaker-profil-2- katalog.

git status

Dette vil gi detaljer om de endrede filene, samt nye filer som er lagt til det lokale arkivet. Hvis du er fornøyd med filene som er endret, legger du til de endrede / nye filene i oppføringsområdet.

git add names_of_files

Hvis alt går rett, kan du trygt legge inn filene.

git commit -m "Din melding her"

Rengjøring av Commit Log og Pushing Changes

Sørg for at din forpliktelse ikke inneholder unødvendige hvite mellomrom eller nye linjer. Det anses som en god praksis å nevne meldingen noe som "Fixing Bug 1040556", av grunner jeg vil forklare deg senere i denne artikkelen. Beholderne av depotet foretrekker hvis du har en enkelt forpliktelse per trekkforespørsel. Så, hvis du har flere enn en forpliktelse lokalt, bør du ta dem tilbake.

git rebase -i HEAD ~ 2

Kommandoen ovenfor antar at du har to forpliktelser, og -Jeg er flagget for interaktiv gjenoppretting. Det vil vise de to forbinder sammen med sine meldinger, som vil ha ordet plukke prefiks. Bare erstatt plukke med squash på en av begavene, og du er god å gå. Det neste skjermbildet knuser bare sammen meldingene. 

Gratulerer, du har vellykket oppdragene. Nå må du bare skyve endringene til GitHub-depotet ditt.

git push

Eller hvis du allerede har presset den første plikten og revet etterpå, kan du prøve følgende kommando.

git push -f

Åpner en trekkforespørsel

Åpne nå ditt online-lager og klikk på knappen for Trekkforespørsler og åpne en ny trekkforespørsel.

Den fyller automatisk tittelen på trekkforespørselen fra commit-meldingen og viser diffen (nedenfor figuren viser diffen for min trekkforespørsel).

Gratulerer, du har gjort din første trekkforespørsel. Men du må fortsatt gjøre noen flere ting. Kopier nettadressen til din forespørselsforespørsel og åpne feilen din på Bugzilla. Å velge Legg til et vedlegg og lim inn nettadressen til trekkforespørselen der. Merk av i avmerkingsboksen som sier patch og legg til et anmeldelseflagg for din mentor.

Hvis du antar at oppdateringen din var korrekt, vil mentoren din fusjonere din forespørselsforespørsel til hovedregisteret, og feilen vil automatisk bli løst av githubroboten på Bugzilla (dette skjer bare hvis commit- og trekkforespørselenavnet inneholder feilnummeret).

Det er ingenting så gledelig som at koden din slås sammen i hovedkoden og blir distribuert til hovedsiden som brukes av millioner av brukere!

Jeg håper at du kunne følge trinnene for å fikse din første feil på Webmaker eller et annet lignende åpen kildekode-prosjekt.