fix: move and aggregate github and git sections

bnszky · bnszky · commit 93d79d1c2d61 · 2025-06-24T05:58:14.000+02:00
diff --git a/astro.config.mjs b/astro.config.mjs
@@ -80,13 +80,22 @@ export default defineConfig({
               label: "Komunikacja",
               link: "/communication",
             },
+          ],
+        },
+        {
+          label: "Git i GitHub",
+          items: [
+            {
+              label: "Poradnik - czym jest Git?",
+              autogenerate: { directory: "/git-github/intro", collapsed: true },
+            },
             {
-              label: "Jak używać githuba?",
-              link: "/github",
+              label: "Jak korzystać z Githuba w Solvro?",
+              link: "/git-github/github",
             },
             {
-              label: "Git handbook",
-              autogenerate: { directory: "git", collapsed: true },
+              label: "Github Projects - zarządzanie projektami",
+              link: "/git-github/github-projects",
             },
           ],
         },
diff --git a/src/content/docs/git/0-intro.mdx b/src/content/docs/git/0-intro.mdx
diff --git a/src/content/docs/github/github-projects.mdx b/src/content/docs/github/github-projects.mdx
diff --git a/src/content/docs/github/github.md b/src/content/docs/github/github.md
@@ -36,11 +36,11 @@ Dzięki publicznemu członkostwu widać Solvro na twoim profilu, a przede wszyst
 1. Wejdź na [https://github.com/orgs/Solvro/people](https://github.com/orgs/Solvro/people)
 2. Namierz siebie na liście członków i kliknij na swoją aktualną widoczność
 
-   ![informacja o prywatności członkostwa](../../assets/github/image2.png)
+   ![informacja o prywatności członkostwa](../../../assets/github/image2.png)
 
 3. Wybierz członkostwo publiczne, i tada! Jesteś już pełnoprawnym członkiem naszego koła.
 
-   ![opcja ustawienia publicznego członkostwa](../../assets/github/image3.png)
+   ![opcja ustawienia publicznego członkostwa](../../../assets/github/image3.png)
 
 ### Podaruj nam gwiazdki ⭐⭐⭐
 
@@ -49,11 +49,11 @@ Zachęcamy do gwiazdkowania naszych publicznych repozytoriów Pokażmy innym, ż
 1. Wchodzimy na listę repozytoriów. Ich publiczna liczba będzie tylko rosła (miejmy nadzieję).
 2. Wchodzimy po kolei w co fajniejsze projekty.
 
-   ![losowo wybrany projekt Solvro](../../assets/github/image9.png)
+   ![losowo wybrany projekt Solvro](../../../assets/github/image9.png)
 
 3. Zostawiamy gwiazdkacza ⭐\!
 
-   ![opcja gwiazdkowania repozytorium](../../assets/github/image5.png)
+   ![opcja gwiazdkowania repozytorium](../../../assets/github/image5.png)
 
 ## Nazewnictwo commitów
 
@@ -151,7 +151,7 @@ Projekty mają wiele zaawansowanych diagramów, z których możecie korzystać w
 
 Podstawowym typem jest jednak tablica KANBAN, gdzie można dodawać zadania w formie draft, lub przypinać issues lub pull-requesty.
 
-![strona projektu](../../assets/github/image8.png)
+![strona projektu](../../../assets/github/image8.png)
 
 #### Flow pracy na boardzie
 
@@ -191,7 +191,7 @@ Jeśli nie rozumiesz technikaliów związanych z którymś z poniższych punktó
 
 Wchodzimy na naszą tablice zadań i przypisujemy się do zadania sygnalizując, że zgłaszamy się do jego zrobienia:
 
-![zgłaszanie się do PR](../../assets/github/image6.png)
+![zgłaszanie się do PR](../../../assets/github/image6.png)
 
 ### Rozpoczęcie pracy nad zadaniem
 
@@ -212,13 +212,13 @@ Wchodzimy na naszą tablice zadań i przypisujemy się do zadania sygnalizując
 1. Gdy jesteśmy gotowi, zmieniamy status taska na **In Review** (jeśli taki status jest w projekcie).
 2. Tworzymy pull requesta z naszego brancha na branch **main** lub **dev** (jeśli aplikacja na main jest już opublikowaną wersją produkcyjną).
 
-   ![przycisk otwórz PR](../../assets/github/image7.png)
+   ![przycisk otwórz PR](../../../assets/github/image7.png)
 
 3. Dodajemy znaczący tytuł (najlepiej powiązany z nazwą lub numerem taska/tasków) i krótko wypisujemy co zmieniliśmy lub dodaliśmy. Jeśli napotkaliśmy jakiś problem/dylemat, możemy wyjaśnić jak go rozwiązaliśmy, jakiej dokonaliśmy decyzji i dlaczego. Jeśli z jakiegoś powodu nie wykonaliśmy 100% zakresu zadania, to jest to dobre miejsce żeby o tym wspomnieć. Jeśli chcesz ładnie sformatować swój opis, obczaj [tą szybką ściągę do gh markdowna](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet).
 4. Można oznaczyć swojego techleada jako reviewer (opcjonalne).
 5. Po prawej na dole, w sekcji _Development_ możesz przypiąć **issue** (np. swoje zadanie), który zostanie automatycznie zamknięty po zmergowaniu tego pull requesta.
 
-   ![dodawanie issues do PR](../../assets/github/image4.png)
+   ![dodawanie issues do PR](../../../assets/github/image4.png)
 
 6. Oczekujemy na code review od naszego techleada.
 7. Przeglądamy komentarze, wprowadzamy sugestie i dyskutujemy nad rzeczami, z którymi się nie zgadzamy. Zadajemy pytania i wprowadzamy zmiany, commitujemy i pushujemy.
@@ -280,5 +280,5 @@ Uwaga: Oprócz README repozytoriów, każdy projekt (kanban board) ma też swoje
 
 To już koniec tego handbooka. Mam nadzieję, że był przydatny i aż tak bardzo nie bolał, mimo zauważalnej liczby stron. Proszę zgłaszać swoje propozycje zmiany tego dokumentu i miłego kodowania 🙂🙃🙂
 
-![Podpis Szymona Kowalińskiego](../../assets/github/image10.png)
+![Podpis Szymona Kowalińskiego](../../../assets/github/image10.png)
 **Wiceprezes VII Zarządu KN Solvro**
diff --git a/src/content/docs/github/intro/1-intro.mdx b/src/content/docs/github/intro/1-intro.mdx
@@ -1,8 +1,8 @@
 ---
-title: Podstawy gita i GitHuba
+title: 1. Github vs Git
 description: oto jak elo zelujemy w solvro
 sidebar:
-  order: 9
+  order: 1
 ---
 
 ![Logo git w kolorystyce Solvro](../../../../assets/tutorials/git-basics/solvro-git-logo.png)
@@ -19,7 +19,18 @@ import { Aside } from "@astrojs/starlight/components";
   na GitHubie KN Solvro to zajrzyj tutaj: [Jak używać githuba?](/github)
 </Aside>
 
+### Inne, przydatne zasoby
+
+- [Oficjalne dokumentacje gita](https://git-scm.com/doc)
+  - Dostępne są strony manpage dla poszczególnych komend, jak również cała książka poświęcona gitowi, częściowo przetłumaczona na polski.
+  - linuxiarze zapewne mają wszystkie manpage gita dostepne lokalnie na ich systemach 😎
+- [Dokumentacja GitHuba](https://docs.github.com/en/get-started)
+  - 90% dokumentacji GitHuba zapewnie dotyczy tylko ich serwisu, ale można tam też znaleźć trochę informacji o samym gitcie i jak używać go razem z GitHubem
+
 #### Spis treści
 
-1. [Jak używać gita](/solvro/podstawy-gita/git)
-1. [Jak korzystać z GitHuba](/solvro/podstawy-gita/github)
+1. [Github vs Git](/git-github/intro/1-intro)
+2. [Teoria gita](/git-github/intro/2-git)
+3. [Kampania jednoosobowa](/git-github/intro/3-singleplayer)
+4. [Współpraca z innymi](/git-github/intro/4-multiplayer)
+5. [Jak korzystać z GitHuba (Podstawy)](/git-github/intro/5-github)
diff --git a/src/content/docs/github/intro/2-git.mdx b/src/content/docs/github/intro/2-git.mdx
@@ -1,8 +1,8 @@
 ---
-title: Jak używać gita
+title: 2. Teoria gita
 description: oto jak elo zelujemy w solvro
 sidebar:
-  order: 10
+  order: 2
 ---
 
 W tym artykule opiszę, po co jest nam git i jak używać jego głównych funkcjonalności.
@@ -72,14 +72,14 @@ Jednakże, jeżeli wszystkie migawki łączyłby liniowy związek, nie możemy 
 
 ![Przykład z jedną gałęzią w git](../../../../assets/tutorials/git-basics/one-branch-ex.png)
 
-Powyższy diagram pokazuje tworzenie commit'ów na jednej gałęzi.  
+Powyższy diagram pokazuje tworzenie commit'ów na jednej gałęzi.
 Załóżmy, że potrzebujesz przetestować, jak wyglądają dwa różne rozwiązania - głupio byłoby w tym celu kopiować i izolować cały projekt czy usuwać jedne rozwiązanie na rzecz drugiego. Zamiast tego wystarczy utworzyć dwie nowe gałęzie.
 
 ### Gałęzie (ang. branches)
 
 ![Przykład wielu gałęzi w git](../../../../assets/tutorials/git-basics/multi-branch-ex.png)
 
-Gałęzie pozwalają ci izolować swoją pracę na jednej wersji repozytorium, nie naruszając innych. Możesz na nich prototypować nowe funkcjonalności bez przeszkadzania innym i rozwalania sobie kodu na gałęzi _main_.  
+Gałęzie pozwalają ci izolować swoją pracę na jednej wersji repozytorium, nie naruszając innych.Możesz na nich prototypować nowe funkcjonalności bez przeszkadzania innym i rozwalania sobie kodu na gałęzi _main_.  
 Aby utworzyć nową gałąź, używamy komendy:  
 `git branch {nazwa_gałęzi}`
 
diff --git a/src/content/docs/github/intro/3-singleplayer.mdx b/src/content/docs/github/intro/3-singleplayer.mdx
@@ -1,9 +1,8 @@
 ---
-title: "Git handbook, rozdział 1: Kampania jednoosobowa"
+title: "3. Kampania jednoosobowa"
 description: "Podstawowe, własne repo z liniową historią"
 sidebar:
-  label: "R1: Kampania jednoosobowa"
-  order: 1
+  order: 3
 ---
 
 import AsciinemaPlayer from "#components/AsciinemaPlayer";
@@ -15,15 +14,6 @@ import {
   CardGrid,
 } from "@astrojs/starlight/components";
 
-## A czym tak właściwie ten git jest?
-
-Git to tzw. system kontroli wersji. (Version Control System, VCS)
-
-Pozwala on na śledzenie, jak pliki w repozytorium zmieniały się na przestrzeni czasu, przez różne wersje, tworzone przez róznych użytkowników.
-
-Ułatwia to współpracę - nie trzeba się bawić z wysyłaniem zipów całego repo, wystarczy zrobić swoje zmiany na swojej gałęzi i/lub forku,
-a następnie powiedzieć osobie odpowiedzialnej za głowną gałęź, by pobrała zmiany z twojej gałęzi.
-
 ## Nowe repozytorium
 
 By móc korzystać z gita, należy stworzyć lub pobrać jakieś repozytorium.
diff --git a/src/content/docs/github/intro/4-multiplayer.mdx b/src/content/docs/github/intro/4-multiplayer.mdx
@@ -1,9 +1,8 @@
 ---
-title: "Git handbook, rozdział 2: Multiplayer sandbox"
+title: "4. Współpraca z innymi"
 description: "Współpraca z innymi, tworzenie i integracja gałęzi"
 sidebar:
-  label: "R2: Multiplayer sandbox"
-  order: 2
+  order: 4
 ---
 
 import AsciinemaPlayer from "#components/AsciinemaPlayer";
@@ -55,7 +54,7 @@ Cała zawartość bloku jest hashowana, a sam blok zawiera hashe bloków bezpoś
 Jakakolwiek zmiana w zawartości bloku zmienia jego hash w nieprzewidywalny sposób, co jednocześnie unieważnia następujące po nim bloki.
 W efekcie **zapisane raz bloki stają się niemodyfikowalne**.
 
-![Git jako blockchain](../../../assets/git/chapter-2/history-01.svg)
+![Git jako blockchain](../../../../assets/git/chapter-2/history-01.svg)
 
 Historia w repozytorium jednak nie do końca musi być liniowa.
 Historia może się po pewnych zapisach rozgałęziać, a te gałęzie mogą się później ponownie łączyć.
diff --git a/src/content/docs/github/intro/5-github.mdx b/src/content/docs/github/intro/5-github.mdx
@@ -1,8 +1,8 @@
 ---
-title: Jak korzystać z GitHuba
+title: 5. Jak korzystać z GitHuba (Podstawy)
 description: oto jak elo zelujemy w solvro
 sidebar:
-  order: 11
+  order: 5
 ---
 
 W tym wpisie zajmiemy się GitHubem. Zakładam, że umiesz już używać gita w lokalnym środowisku.
@@ -152,12 +152,12 @@ Poniżej tych pól wyświetlą nam się do podglądu zmiany w kodzie.
 
 ![Pull request edit window](../../../../assets/tutorials/git-basics/pull-request-1.png)
 
-Może zdarzyć się tak, że przy dodawaniu PR pojawią się konflikty. Możemy znów sfetchować repo do siebie i naprawić je lokalnie, po czym wysłać z powrotem na upstream,
+Może zdarzyć się tak, że przy dodawaniu PR pojawią się konflikty.Możemy znów sfetchować repo do siebie i naprawić je lokalnie, po czym wysłać z powrotem na upstream,
 ale do mniejszych PR w pełni wystarczający jest webowy edytor tekstowy GitHuba.
 
 ![Conflicts in github editor](../../../../assets/tutorials/git-basics/pull-request-2.png)
 
-Kiedy już rozwiążemy konflikty, pojawi się nam opcja scalania gałęzi. Możemy tu wybrać metodę scalania (zwykłe, squash, rebase). Wystarczy zaznaczyć tę, która najbardziej
+Kiedy już rozwiążemy konflikty, pojawi się nam opcja scalania gałęzi.Możemy tu wybrać metodę scalania (zwykłe, squash, rebase). Wystarczy zaznaczyć tę, która najbardziej
 nam pasuje i już. Gotowe! Zmerge'owaliśmy nasze zmiany do main. Jeżeli jesteśmy pewni, że wszystko działa tak, jak powinno - a na tym etapie powinniśmy być - to możemy usunąć zbędną gałąź.
 
 _Reminder: Nie zawsze mamy uprawnienia do samodzielnego dodawania zmian na main i merge'ować musi np. nasz tech-lead._
diff --git a/src/content/docs/sections/Management/Guides/github-projects.mdx b/src/content/docs/sections/Management/Guides/github-projects.mdx
