Det er svært. Det er altid svært når det er første gang. Specielt hvis man samarbejder er det ikke rart at begå fejl. Vi vil simplificere den store udfordring det er for nybegyndere at lære om open-source, og at lave deres første bidrag.
At læse artikler og se video guides hjælper, men hvad er bedre end at bruge det i praksis? Dette projekt håber at kunne tilbyde vejledning og gøre det overkommeligt for alle at lave deres første open-source bidrag.
Hvis du ikke er komfortabel med command line, her er vejledninger til GUI værktøjer
Har du ikke Git på din maskine kan du installere det.
Fork dette repo ved at klikke på "fork" knappen øverst på siden. Dette vil lave en kopi af projektet i din Github konto.
Næste trin er at "clone" dit nye repository til din maskine. Naviger til din Github account og åbn dit nye repository, derefter find "clone" øverst oppe og tryk på knappen. Tryk copy to clipboard ikonet.
Åbn en terminal og kør den følgende git command:
git clone "din url"
hvor "din url" skal erstattes med den URL du kopieret i forrige trin.
Eksempel:
git clone https://github.com/dit-brugernavn/first-contributions.git
Erstat 'dit-brugernavn' med dit GitHub brugernavn. Her kopierer vi indholdet af first-contributions repositoriet fra din Github konto, til din lokale PC.
Åbn en konsol og cd til dit lokale repository (hvis ikke du allerede er der):
cd first-contributions
Derefter opretter du en branch med kommandoen git checkout
:
git checkout -b <add-your-change>
Eksempel:
git checkout -b add-alonzo-church
(Navnet på din branch behøver ikke at indeholde ordet add, men det giver mening at inkludere det her da branchen er til for at tilføje dit navn til en liste med navne.)
Åben filen Contributors.md
i en text editor og tilføj dit navn til listen. Undgå at tilføje dit navn øverst eller nederst på listen, men helst et sted i mellem. Når dette er gjort så gem filen.
Hvis du går til konsollen og kører kommandoen git status
, vil du se dine ændringer.
Tilføj disse ændringer til din branch med kommandoen git add
:
git add Contributors.md
Derefter commit ændringerne med kommandoen git commit
:
git commit -m "Add <dit-navn> to Contributors list"
Erstat <dit-navn>
med dit Github brugernavn.
Push dine ændringer til Github med kommandoen git push
:
git push origin <add-din-branch>
Erstat <add-din-branch>
med navnet på den branch du oprettede tidligere.
Hvis du går ind på dit repository på Github, så vil du se en compare & pull request
knap. Klik på den.
Indgiv nu din pull request.
Snart vil jeg merge dine ændringer ind i master branch'en af projektet. Du vil modtage en notifikation per email når dine ændringer er blevet merget.
Tillykke! Du har nu gennemført den udbredte fork -> clone -> edit -> PR workflow som du vil støde oftest på som contributor!
Fejr dit bidrag og del det med dine venner og følgere ved at gå til web app.
Du er velkommen til at kigge forbi vores Slack hvis du mangler hjælp, eller har spørgsmål. Join slack team.
Tillad os også at hjælpe dig i gang med dine næste bidrag. Vi har kompileret en liste af projekter med letty, overkommelige problemer du kan starte ud med. Check den ud her: the list of projects in web app.
GitHub Desktop | Visual Studio 2017 | GitKraken | Visual Studio Code |