Merge branch 'main' of https://github.com/Solvro/web-solvro-docs into feat/nest-backend

Author: dawidlinek

astro.config.mjs

@@ -80,13 +80,22 @@ export default defineConfig({
               label: "Komunikacja",
               link: "/communication",
             },
+          ],
+        },
+        {
+          label: "Git i GitHub",
+          items: [
+            {
+              label: "Poradnik wstępny",
+              autogenerate: { directory: "/git-github/intro", collapsed: true },
+            },
             {
-              label: "Jak używać githuba?",
-              link: "/github",
+              label: "Zasady działania z Git i Github w Solvro",
+              link: "/git-github/solvro",
             },
             {
-              label: "Git handbook",
-              autogenerate: { directory: "git", collapsed: true },
+              label: "Github Projects - zarządzanie projektami",
+              link: "/git-github/github-projects",
             },
           ],
         },

src/content/docs/git-github/github-projects.mdx

@@ -0,0 +1,37 @@
+---
+title: 1. Wstęp - Różnice Git vs GitHub
+description: oto jak elo zelujemy w solvro
+sidebar:
+  order: 1
+---
+
+![Logo git w kolorystyce Solvro](../../../../assets/tutorials/git-basics/solvro-git-logo.png)
+
+Ten poradnik jest dla osób, które chcą nauczyć się lub odświeżyć swoją wiedzę z podstaw gita lub GitHuba. Omówimy tu ich podstawowe funkcje.
+
+- Git jest to **System Kontroli Wersji** (ang. Version Control System) - must-have, jeżeli pracujesz w zespole oraz nieoceniona pomoc w jednoosobowych projektach.
+- GitHub natomiast to platforma, która pozwala tworzyć, dzielić się z innymi i zarządzać repozytoriami git, co ułatwia współpracę z innymi oraz stanowi swoiste portfolio dla programisty.
+
+import { Aside } from "@astrojs/starlight/components";
+
+<Aside type="tip" title="Disclaimer">
+  Jeżeli potrafisz już używać tych narzędzi, a chcesz zobaczyć jak udzielać się
+  na GitHubie KN Solvro to zajrzyj tutaj: [Jak używać
+  githuba?](/git-github/solvro)
+</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. [Wstęp - Różnice Git vs GitHub](/git-github/intro/1-intro)
+2. [System kontroli wersji - jak działa?](/git-github/intro/2-git)
+3. [Pierwsze repozytorium](/git-github/intro/3-singleplayer)
+4. [Współpraca z innymi](/git-github/intro/4-multiplayer)
+5. [Integracja z GitHub](/git-github/intro/5-github)

src/content/docs/git-github/intro/1-intro.mdx

@@ -1,8 +1,8 @@
 ---
-title: Jak używać gita
+title: 2. System kontroli wersji - jak działa?
 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}`
 
@@ -98,7 +98,7 @@ Jeżeli mamy zmiany na jednej gałęzi i chcemy się przenieść na inną, git n
 W takiej sytuacji możemy użyć `git stash` - komenda ta cofnie nasze zmiany z gałęzi i zapisze je w **_schowku_**.  
 Kiedy wrócimy z powrotem na gałąź, gdzie użyliśmy `git stash`, wystarczy użyć `git stash pop` i przywrócimy ją do stanu, w którym ją zostawiliśmy.
 
-### Merge & rebase
+### Merge i rebase
 
 No dobrze, podobają mi się moje zmiany, jak mogę je dodać do głównej wersji projektu - gałęzi main?
 

…ontent/docs/solvro/Podstawy Gita/git.mdx …/content/docs/git-github/intro/2-git.mdxsrc/content/docs/solvro/Podstawy Gita/git.mdx renamed to src/content/docs/git-github/intro/2-git.mdx src/content/docs/solvro/Podstawy Gita/git.mdx renamed to src/content/docs/git-github/intro/2-git.mdx

@@ -1,9 +1,8 @@
 ---
-title: "Git handbook, rozdział 1: Kampania jednoosobowa"
+title: "3. Pierwsze repozytorium"
 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.
@@ -219,7 +209,7 @@ Opis zapisu składa się z kilku części:
   Przykładem jest `Co-authored-by: autor <[email protected]>`, który służy do oznaczania współautorów zapisu.
   Zazwyczaj wstawia je się po opisie, zostawiając jedną pustą linijkę.
 
-Różne organizacje, projekty i autorzy mają różne opinie na temat stylu opisów. Styl używany w Solvro został opisany [w handbooku dla GitHuba](/github#nazewnictwo-commitów).
+Różne organizacje, projekty i autorzy mają różne opinie na temat stylu opisów. Styl używany w Solvro został opisany [w handbooku dla GitHuba](/git-github/solvro#nazewnictwo-commitów).
 
 import commit03 from "#assets/git/chapter-1/committing-03.cast";
 

src/content/docs/git/1-singleplayer.mdx …docs/git-github/intro/3-singleplayer.mdxsrc/content/docs/git/1-singleplayer.mdx renamed to src/content/docs/git-github/intro/3-singleplayer.mdx src/content/docs/git/1-singleplayer.mdx renamed to src/content/docs/git-github/intro/3-singleplayer.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";
@@ -30,7 +29,7 @@ Zacznijmy od sklonowania repozytorium z poprzedniego przykładu.
 W rzeczywistości, będzie to najczęściej repo na jakimś hostcie repo (np. GitHub).
 By sklonować repozytorium, wystarczy znaleźć jego adres, a następnie wykonać komendę `git clone <adres> [katalog docelowy]`.
 Można podać katalog, do którego ma się to repo sklonować - domyślnie będzie to nowy katalog w aktualnym katalogu, o nazwie repozytorium wyciągniętej z adresu.
-W przypadku niektórych repozytoriów i protokołów dostępu, może być trzeba skonfigurować dostępy, tak jak w przypadku [publikacji zmian](/git/1-singleplayer/#publikacja-zmian).
+W przypadku niektórych repozytoriów i protokołów dostępu, może być trzeba skonfigurować dostępy, tak jak w przypadku [publikacji zmian](/git-github/intro/3-singleplayer/#publikacja-zmian).
 
 import contributing01 from "#assets/git/chapter-2/contributing-01.cast";
 
@@ -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ć.
@@ -286,7 +285,8 @@ import review02 from "#assets/git/chapter-2/review-02.cast";
 ## Integracja
 
 Gdy już przejrzeliśmy zmiany i nie mamy żadnych zastrzeżeń, czas na ich zintegrowanie.
-Git posiada kilka sposobów na integrowanie zmian, które opiszę poniżej.
+Git posiada kilka sposobów na integrowanie zmian, które zostały przedstawione w [podstawach łączenia branchy](/git-github/intro/2-git/#merge-i-rebase).
+Natomiast poniżej rozszerzona wersja zawierająca plusy i minusy każdego z rozwiązań.
 
 ### Standardowy merge
 

src/content/docs/git/2-multiplayer.mdx …/docs/git-github/intro/4-multiplayer.mdxsrc/content/docs/git/2-multiplayer.mdx renamed to src/content/docs/git-github/intro/4-multiplayer.mdx src/content/docs/git/2-multiplayer.mdx renamed to src/content/docs/git-github/intro/4-multiplayer.mdx

@@ -1,8 +1,8 @@
 ---
-title: Jak korzystać z GitHuba
+title: 5. Integracja z GitHub
 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._

…ent/docs/solvro/Podstawy Gita/github.mdx …ntent/docs/git-github/intro/5-github.mdxsrc/content/docs/solvro/Podstawy Gita/github.mdx renamed to src/content/docs/git-github/intro/5-github.mdx src/content/docs/solvro/Podstawy Gita/github.mdx renamed to src/content/docs/git-github/intro/5-github.mdx

@@ -1,6 +1,6 @@
 ---
-title: Github
-description: Jak korzystać z Githuba w Solvro?
+title: GitHub w Solvro (Podstawy użytkowania)
+description: Jak korzystać z GitHuba w Solvro? (Zasady użytkowania)
 sidebar:
   order: 0
 ---
@@ -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**

src/content/docs/github.md src/content/docs/git-github/solvro.mdsrc/content/docs/github.md renamed to src/content/docs/git-github/solvro.md

@@ -26,7 +26,7 @@ Miło nam Cię powitać w otwartej dokumentacji organizacyjnej KN Solvro. Jest t
 
 <LinkCard title="Jak pracujemy" href="/solvro/structure" />
 <LinkCard title="Komunikacja" href="/communication" />
-<LinkCard title="GitHub" href="/github" />
+<LinkCard title="GitHub" href="/git-github/intro/1-intro/" />
 
 ### Dla starych wyjadaczy