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 förenkla för dig att lära sig 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.
Läs detta på andra språk.
Om du inte har git installerat så installera det
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 repot till din dator. Gå till ditt GitHub-konto och klicka på clone-knappen och klicka sedan på copy to cliboard-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.
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 git checkout
-kommandot:
git checkout -b <lägg till ditt branch-namn>
Till exempel:
git checkout -b mitt-tillag
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.
Ge kommando git status
i projektkatalogen för att se de ändringar du gjort.
Lägg till dina ändringar genom att använda kommando git add -A
:
git add -A
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 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.
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.
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 ställa frågor 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.
GitHub Desktop | Visual Studio 2017 | GitKraken |
Om du tyckte om detta projektet kan du tilldela stjärnor på GitHub. Känner du dig särskilt snäll kan du följa Roshan på Twitter och GitHub.