Wprowadzenie do Git i GitHub
Cel
Zrozumiesz, czym są Git i GitHub oraz jak będą wykorzystywane w pracy Sieci.
Najważniejsze w jednym zdaniu
Git pozwala zapisywać i śledzić zmiany w plikach, a GitHub umożliwia wspólną pracę nad tymi plikami przez Internet.
Jak będziemy z tego korzystać
W pracy Sieci GitHub służy do:
- dodawania projektów dokumentów,
- komentowania i poprawiania dokumentów innych osób,
- wprowadzania zmian do już opublikowanych materiałów,
- prezentacji dorobku Sieci na stronie internetowej.
Nie musisz znać wszystkich funkcji Git i GitHub. Wystarczy, że opanujesz kilka podstawowych działań, opisanych w kolejnych poradnikach.
Podstawowe pojęcia (tylko niezbędne)
- Repozytorium – miejsce, w którym znajdują się pliki projektu.
- Commit – zapisanie zmian w plikach.
- Pull request – propozycja zmiany w projekcie (np. nowy dokument lub poprawka).
- Komentarz – uwaga do dokumentu lub propozycja zmiany.
To wystarczy na początek. Pozostałe pojęcia poznasz w trakcie pracy.
Jak wygląda praca w praktyce
Najczęściej wykonasz jeden z czterech typów działań:
1. Dodanie nowego dokumentu
- tworzysz plik,
- zapisujesz zmiany,
- zgłaszasz propozycję dodania (pull request).
2. Komentowanie dokumentu
- otwierasz dokument,
- dodajesz komentarz lub propozycję zmiany.
3. Poprawa istniejącego dokumentu
- wprowadzasz zmiany,
- zgłaszasz je do akceptacji (pull request).
4. Przeglądanie projektów
-
gotowe, opublikowane projekty znajdziesz na stronie: https://siec-dostepnosci-cyfrowej.github.io/sdc/
-
projekty zgłoszone, ale jeszcze niescalone, możesz przeglądać na karcie „Pull requests” w repozytorium
-
w pierwszym komentarzu do projektu znajdziesz też link do jego podglądu
Co jest najważniejsze
Nie musisz rozumieć wszystkich pojęć technicznych.
Najważniejsze jest to, aby:
- dodawać swoje propozycje,
- komentować prace innych,
- reagować na uwagi do własnych dokumentów.
Praca z GitHub przy użyciu czytnika ekranu
- kieruj się nazwami elementów, nie ich położeniem
- używaj klawisza Tab do przechodzenia między elementami
- korzystaj z listy przycisków i linków w czytniku
- używaj wyszukiwania na stronie (Ctrl+F), aby szybko znaleźć element
- jeśli nie możesz znaleźć elementu, dodaj komentarz ogólny zamiast szczegółowego
GitHub może działać inaczej w zależności od czytnika i przeglądarki.
Co dalej
Przejdź do kolejnych poradników: