First Contributions

Det är alltid svårt första gången man gör något och speciellt när du samarbetar med andra kan det vara extra känsligt att göra misstag. Vi vill göra det lättare för dig att lära dig hur man bidrar till ett öppet källkods-projekt.

Att läsa artiklar och titta på handledningar kan så klart hjälpa men det är alltid bättre att göra det på riktigt. Detta projeket har som syfte att tillhandahålla en guide och göra det enkelt för nybörjare att göra sina första bidrag. Om du är ute efter att göra ditt första bidrag kan du följa stegen nedan.

Om du inte känner dig bekväm med kommandoraden, så finns en vägledning här.

Om du inte har git installerat så installera det

Gör en Fork på detta repository

Forka repot genom att klicka på fork-knappen överst på denna sida. Detta kommer att skapa en kopia av repot i ditt GitHub-konto.

Klona repository

Klona repot till din dator. Gå till ditt GitHub-konto och klicka på clone-knappen och klicka sedan på copy to clipboard-ikonen.

Öppna en terminal och kör följande kommando:

git clone "url you just copied"

där "url you just copied" (utan citat-tecken) är URL:en för detta repo (din fork för detta projekt). Se föregående steg för att hitta URL:en.

Till exempel:

git clone https://github.com/this-is-you/first-contributions.git

där this-is-you är ditt användarnamn på GitHub. På detta sätt kopierar du innehållet i repot till din dator.

Skapa en branch

Gå till repo-katalogen på din dator (om du inte redan står i den katalogen):

cd first-contributions

Nu skapar du en branch genom att använda kommandot git checkout:

git checkout -b <lägg till ditt branch-namn>

Till exempel:

git checkout -b mitt-tillag

Gör de ändringar du vill göra och commita dem

Nu öppnar du Contributors.md i en text-editor och lägger till ditt namn. Lägg inte till något i början eller slutet av dokumentet utan lägg till någonstans mitt emellan. Spara filen.

Mata in kommandot git status i projektkatalogen för att se de ändringar du gjort.

Lägg till dina ändringar genom att använda kommando git add:

git add Contributors.md

Commita dina ändringar genom att använda git commit:

git commit -m "Add <your-name> to Contributors list"

ersätt <your-name> med ditt namn.

Pusha ändringar till GitHub

Pusha dina ändringar genom att använda kommando git push:

git push origin <add-your-branch-name>

ersätt <add-your-branch-name> med det branch-namn du använt tidigare.

Skicka iväg dina ändringar för granskning

Om du navigerar till ditt repo på GitHub kan du se en knapp med texten Compare & pull request. Klicka på den.

Skicka iväg din s.k. pull request.

Snart kommer jag införa dina ändringar i huvudprojektet. Du kommer att få ett e-mail så fort dina ändringar blivit införda.

Hur går man vidare?

Gratulerar! Du har just genomfört standardprocessen för fork -> clone -> edit -> PR, en process du kommer att stöta på ofta!

Fira genom att dela med dina vänner och följare genom att gå till web app.

Behöver du hjälp eller vill du ställa frågor så kan du gå med i vår slack-grupp. Gå med i slack-gruppen.

Nu kan du gå vidare genom att bidra i andra projekt. Vi har sammanställt en lista med enkla uppgifter som du kan starta med. Kolla in projektlistan i webbapplikationen.