README.da.md

Første bidrag

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 repository

Fork dette repo ved at klikke på "fork" knappen øverst på siden. Dette vil lave en kopi af projektet i din Github konto.

Clone dette repository

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.

Opret en branch

Å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.)

Lav dine ændringer og commit dem

Å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 ændringer til Github

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.

Indgiv ændringer til inspektion

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.

Hvor til nu?

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.

ekstra materiale

Guides med andre værktøjer

GitHub Desktop	Visual Studio 2017	GitKraken	Visual Studio Code