Att samarbeta på GitHub

Det här lär du dig

• Arbetsgången med issue, gren, pull requestpull requestPull request (PR)Ett förslag om att föra in ändringarna från en branch i en annan, så att andra kan granska och diskutera dem först.Läs mer om pull request, granskning och merge.
• Två sätt att samarbeta: som medarbetare i samma repository, eller med en fork.
• Att göra ett repository publikt, och vad som då blir synligt.

Varför behövs det här?

I modul 5 kunde två datorer dela ett repository. Men alla som får skicka kan skicka direkt till main, och ingen ser ändringen innan den gäller. I ett samarbete vill man diskutera vad som ska göras, och låta någon annan läsa en ändring innan den förs in. Det är vad den här modulen handlar om.

Så hänger det ihop

1. Issue: någon beskriver ett fel eller en idé. Issuen får ett nummer, till exempel #1.
2. Gren: du skapar en grengrenBranchEn egen utvecklingslinje i ett repository, där man kan göra ändringar utan att påverka huvudversionen.Läs mer om gren för uppgiften och gör dina commits, precis som i modul 4.
3. git push: du skickar grenen till GitHub, som i modul 5.
4. Pull request: du föreslår att grenen förs in i main, och skriver vad den gör.
5. Granskning: någon annan läser ändringen och kommenterar. Du rättar med nya commits på samma gren.
6. Merge: när förslaget är godkänt förs det in i main. Issuen stängs, och alla hämtar resultatet med git pull.

Issues och pull requests är inte en del av GitGitGitEtt program som sparar versioner av filerna i ett projekt, så att man kan se vad som ändrats, gå tillbaka till tidigare versioner och arbeta flera samtidigt.Läs mer om Git. De är funktioner i GitHub och liknande tjänster. Git-delen känner du redan till: grenar, commits, push och pull.

Två sätt att samarbeta

Sätt	Hur	När
Medarbetare (collaborator)	Ägaren bjuder in dig. Du får skicka grenar direkt till repositoryt.	Ett projekt ni gör tillsammans.
Fork	Du gör en egen kopia av repositoryt på GitHub, skickar dit och föreslår ändringen därifrån.	Ett projekt där du inte har behörighet, till exempel ett öppet projekt.

Lektion 2–6 använder det första sättet. Forkar kommer i lektion 7.

Publikt repository

I den här modulen ska resplanen ligga i ett publikt repository. Det beror på att skyddade grenar, som du lär dig i lektion 6, bara ingår gratis för publika repositories på GitHub.

Allt i ett publikt repository syns för alla: filerna, hela historiken och namnet och e-postadressen i varje commit. Har dina tidigare commits din vanliga e-postadress blir den alltså synlig. Det säkraste är att börja om i ett nytt repository.

Så fungerar det: börja om i ett nytt repository

Ett nytt repository har ingen gammal historik. Har du ställt in GitHubs särskilda adress, den som slutar på @users.noreply.github.com, får alla commits i det nya repositoryt den adressen. Det är det säkraste sättet.

Exempel

Så här kan du börja om. Mappen resplan-samarbete får en kopia av den senaste resplanen, men ingen gammal historik:

Terminal

mkdir resplan-samarbete
cd resplan-samarbete
git init
# kopiera resplan.txt hit, till exempel från resplan-git
git add resplan.txt
git commit -m "Första versionen av resplanen"

Skapa sedan ett publikt, tomt repository på GitHub och skicka dit, som i modul 5.

Övning

Gör så här: ett publikt repository för modulen

1. Kontrollera vilken e-postadress Git använder: git config --global user.email. Ställ in GitHubs särskilda adress om du inte vill visa din vanliga, som i modul 5.
2. Välj ett av sätten:
   • Nytt repository (rekommenderas): skapa mappen resplan-samarbete som i exemplet. Skapa ett tomt, publikt repository med samma namn på GitHub, och skicka med git remote add origin <adress> och git push -u origin main.
   • Gör resplanen publik: bara om du inte har något emot att historiken och adressen i dina commits syns. På GitHub: öppna repositoryt, välj Settings, rulla ner till Danger Zone och välj Change visibility. Följ stegen och bekräfta med Make this repository public.
3. Öppna repositoryt på GitHub och kontrollera att det står Public vid namnet.
4. Arbetar du med någon annan: välj Settings och Collaborators, klicka på Add people och sök fram den andras användarnamn. Den andra måste acceptera inbjudan, som kommer med e-post.

Du kan göra hela modulen ensam. Det som kräver två personer står i lektionerna.

Vanliga problem

Om det inte fungerar: jag hittar inte Settings

Bara ägaren och den som har administratörsbehörighet ser Settings. Kontrollera att du är inloggad med rätt konto, och att du står i ditt eget repository och inte i någon annans. Är fönstret smalt kan Settings ligga under en meny med tre punkter.

Om det inte fungerar: jag har gjort ett repository publikt med fel innehåll

Gör det privat igen på samma sätt, med Change visibility. Tänk på att andra kan ha hunnit se eller klona det. Har ett lösenord eller en nyckel kommit med: byt lösenordet eller nyckeln. Mer om det i modul 7.

Testa dig själv

1. Vilka av följande är funktioner i GitHub, och inte i Git? (Välj alla som stämmer)

• Issues
• Pull requests
• Grenar
• Commits

Visa rätt svar

• Issues
• Pull requests

2. Du vill rätta ett fel i ett öppet projekt där du inte får skicka till repositoryt. Vad gör du?

• Gör en fork, skicka dit och öppna en pull request till originalet
• Be ägarna om ditt lösenord
• Skicka direkt till main i originalet

Visa rätt svar

• Gör en fork, skicka dit och öppna en pull request till originalet

3. Du gör ditt repository publikt. Vad blir synligt för alla? (Välj alla som stämmer)

• Filerna
• Hela historiken
• Namnet och e-postadressen i varje commit
• Ditt lösenord till GitHub

Visa rätt svar

• Filerna
• Hela historiken
• Namnet och e-postadressen i varje commit

Rätta

Sammanfattning

• Arbetsgången: issue, gren, git push, pull request, granskning och merge.
• Issues och pull requests är funktioner i GitHub, inte i Git.
• Medarbetare skickar till samma repository. Med en fork föreslår du ändringar från en egen kopia.
• I ett publikt repository syns hela historiken, med namn och e-postadress i varje commit.