Det er alltid vanskelig å gjøre noe for første gang. Spesielt når man samarbeider med andre kan det være tungt å gjøre feil. Vi ønsker å gjøre det lettere for nybegynnere å bidra til open-source.
Å lese artikler og se videoer kan hjelpe, men hva kan vel være bedre enn å gjøre det i praksis? Dette prosjektet håper å kunne tilby en enkel veiledning og gjøre det lett for nybegynnere å gi sitt første bidrag. Følg trinnene nedenfor hvis du ønsker å gi ditt første bidrag til dette prosjektet.
Hvis du ikke er komfortabel med terminal, så finnes det andre metoder.
Om du ikke har git installert på din maskin, følg denne veiledningen.
Fork prosjektet ved å klikke på "fork" knappen på toppen av denne siden. Dette vil legge til en kopi av dette prosjektet til din GitHub konto (prosjekter kalles repository på GitHub).
Nå skal vi klone prosjektet fra GitHub til din maskin. Gå til din GitHub konto og åpne din nye fork, deretter klikk på "clone" knappen og kopier linken.
Åpne en terminal/kommandolinje og kjør følgende git kommando:
git clone <din-link>
Erstatt <din-link>
med linken du kopierte i forrige trinn.
Eksempel:
git clone https://github.com/ditt-brukernavn/first-contributions.git
hvor ditt-brukernavn
er ditt GitHub brukernavn. Her kopierer vi innholdet i first-contributions prosjektet fra din GitHub konto til din lokale maskin.
Naviger terminalen inn i prosjektet (hvis du ikke er der allerede):
cd first-contributions
Opprett en branch med git checkout
kommandoen:
git checkout -b <navn-til-branch-her>
Eksempel:
git checkout -b add-alonzo-church
Navnet på din branch behøver ikke å inneholde ordet add, men det gir mening å inkludere det i denne sammenhengen. Endre "alonzo-church" til ditt navn.
Åpne filen Contributors.md
i et program for å redigere tekst og legg til ditt navn i listen. Ikke legg det til i begynnelsen eller slutten av filen, legg det til hvor som helst i mellom. Når du har gjort dette kan du lagre filen.
Hvis du åpner terminalen igjen og kjører kommandoen git status
, vil du se dine endringer.
Legg endringene til i din nye branch med kommandoen git add
:
git add Contributors.md
Commit endringene med kommandoen git commit
:
git commit -m "Add <ditt-navn> to Contributors list"
Erstatt <ditt-navn>
med ditt navn.
Push til GitHub med kommandoen git push
:
git push origin <navn-på-din-branch>
Erstatt <navn-på-din-branch>
med navnet på branch som du opprettet tidligere.
Hvis du går til ditt prosjekt på GitHub, vil du se en Compare & pull request
knapp. Klikk på den for å opprette en pull request.
Send inn din pull request når du er klar.
Snart vil jeg merge dine endringer inn i master branch av mitt prosjekt. Du vil motta en notifikasjon på epost når dine endringer er lagt til.
Gratulerer! Du har gjennomført standardprosessen for fork -> clone -> edit -> PR, en prosess du vil møte på ofte!
Feir ditt bidrag og del det med dine venner og følgere ved å gå til web app.
Behøver du hjelp eller vil stille spørsmål så kan du bli med i vår slack-gruppe. Join slack team.
Nå kan du gå videre og bidra til andre open-source prosjekter. Vi har satt sammen en liste med enkle og overkommelige problemer du kan starte med. Sjekk den ut her: the list of projects in the web app.
GitHub Desktop | Visual Studio 2017 | GitKraken | Visual Studio Code | Atlassian Sourcetree |