github.md

Jak pracować z github

1. Pierwszy krok to założenie konta na stronie GitHub

2. Po zalogwaniu się na swoje konto tworzymy tzw. Fork repozytorium z którym chcemy pracować. Fork oznacza naszą prywatną kopie danego repozytorium na którym możemy dokonywać swoich poprawek. Tworzenie forka jest banalnie prosta - wystarczy wcisnąć przycisk w prawym górnym rogu ekranu

3. Po przejściu na swojego forka widzimy że jesteśmy już na naszej kopii [1]. Możemy pobrać ją do lokalnej edycji wciskając przycisk Code [2] i pobierając link [3]

4. Praca z linii poleceń

   • Następnie należy zainstalować Git for Windows dzięki któremu będziemy mogli pobrać repozytorium na dysk komputera

   • Z linii poleceń (cmd, PowerShell, Windows Terminal) możemy pobrać repozytorium. Pamiętajmy o założeniu folderu na dysku zanim wpiszemy poniższe polecenie. Wykonując polecenie git clone wraz ze skopiowanym adresem

   • Teraz dokonujemy zmian które chcemy zaproponować. W każdym momencie używając polecenia git status możemy zobaczyć jakie pliki zostały zmienione.

   • Jeśli chcemy zachować swoje zmiany wykonujemy polecenie git add . które spowoduje że wszystkie zmienione pliki staną się kandydatami do tzw. commita czyli paczce ze zmianami które wyślemy do repozytorium. Następnie używając polecenia git commit -m "Opis naszych zmian" tworzymy naszego commita.

   • Takich commitów możemy robić więcej jeśli chcemy naszą pracę podzielić na osobne części. Po zakończeniu pracy możemy nasze zmiany wysłać na serwer poleceniem git push

   • Po wykonaniu operacji push będzie ona widoczna na serwerze jednak tylko na naszym forku

5. Praca z Fork

   • Pobieramy aplikację Fork
   • Klonujemy repozytorium

   

   • Po wykonaniu przez nas zmian musimy przenieść pliki do sekcji stage używając przycisku `Stage' dla pojedyńczego pliku lub podwójnej strzałki dla wszystkich
   • Na podstawie plików z sekcji stage tworzymy nowy commit
     
   • W celu wysłania stworzonych commitów na serwer używamy opcji push.

   

6. W celu przeniesienia zmian na główne repozytorium z którego stworzyliśmy naszego forka musimy stworzyć tzw. Pull Request a więc prośbę o wgranie naszych zmian do repozytorium głównego. Możemy to zrobić w zakłądce Pull Requests wybierając opcje New pull request

7. Po wciśnięciu przycisku widzimy informacje z jakiego forka tworzony jest nasz pull request oraz widizmy listę zmian które wykonaliśmy. Pamiętajmy, że jeśli ktoś inny wykonał zmiany w tych samych plikach i ubiegł nas przed wgraniem naszych to mogą wystąpić konflikty które będzie trzeba rozwiązać. Po wciśnięciu przycisku `Create new pull reqest' przenosimy się do ekranu koentarza

8. Możemy dodać komentarz do naszych zmian i po wniśnięciu przycisku `Create pull request' nasz PR będzie gotowy

9. Nasz Pull Request jest gotowy i czeka na akceptację przez administratorów repozytorium. Możliwe, że dostaniemy komentarz i będziemy musieli coś poprawić lub administrator stwierdzi, że nie zgadza się na nasze zmiany.

10. Jeśli ostatecznie wszystko będzie ok i dostaniemy akceptację wtedy będziemy mogli wykonać tzw. Merge czyli wgranie naszych zmian do głównego repozytorium