Skip to content

Commit f601943

Browse files
dawidlinekRei-x
authored andcommitted
feat: move github and communication to start here
1 parent 5ee2ee3 commit f601943

File tree

7 files changed

+22
-14
lines changed

7 files changed

+22
-14
lines changed

astro.config.mjs

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -77,6 +77,14 @@ export default defineConfig({
7777
label: "Jak pisać dokumentacje?",
7878
link: "/how-to-write-docs",
7979
},
80+
{
81+
label: "Komunikacja",
82+
link: "/communication",
83+
},
84+
{
85+
label: "Jak używać githuba?",
86+
link: "/github",
87+
},
8088
],
8189
},
8290
{

src/content/docs/sections/Management/Communication Channels.md renamed to src/content/docs/communication.md

File renamed without changes.

src/content/docs/sections/Management/Github.md renamed to src/content/docs/github.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -36,11 +36,11 @@ Dzięki publicznemu członkostwu widać Solvro na twoim profilu, a przede wszyst
3636
1. Wejdź na [https://github.com/orgs/Solvro/people](https://github.com/orgs/Solvro/people)
3737
2. Namierz siebie na liście członków i kliknij na swoją aktualną widoczność
3838

39-
![informacja o prywatności członkostwa](../../../../assets/github/image2.png)
39+
![informacja o prywatności członkostwa](../../assets/github/image2.png)
4040

4141
3. Wybierz członkostwo publiczne, i tada! Jesteś już pełnoprawnym członkiem naszego koła.
4242

43-
![opcja ustawienia publicznego członkostwa](../../../../assets/github/image3.png)
43+
![opcja ustawienia publicznego członkostwa](../../assets/github/image3.png)
4444

4545
### Podaruj nam gwiazdki ⭐⭐⭐
4646

@@ -49,11 +49,11 @@ Zachęcamy do gwiazdkowania naszych publicznych repozytoriów Pokażmy innym, ż
4949
1. Wchodzimy na listę repozytoriów. Ich publiczna liczba będzie tylko rosła (miejmy nadzieję).
5050
2. Wchodzimy po kolei w co fajniejsze projekty.
5151

52-
![losowo wybrany projekt Solvro](../../../../assets/github/image9.png)
52+
![losowo wybrany projekt Solvro](../../assets/github/image9.png)
5353

5454
3. Zostawiamy gwiazdkacza ⭐\!
5555

56-
![opcja gwiazdkowania repozytorium](../../../../assets/github/image5.png)
56+
![opcja gwiazdkowania repozytorium](../../assets/github/image5.png)
5757

5858
## Nazewnictwo repozytoriów
5959

@@ -151,7 +151,7 @@ Projekty mają wiele zaawansowanych diagramów, z których możecie korzystać w
151151

152152
Podstawowym typem jest jednak tablica KANBAN, gdzie można dodawać zadania w formie draft, lub przypinać issues lub pull-requesty.
153153

154-
![strona projektu](../../../../assets/github/image8.png)
154+
![strona projektu](../../assets/github/image8.png)
155155

156156
#### Flow pracy na boardzie
157157

@@ -191,7 +191,7 @@ Jeśli nie rozumiesz technikaliów związanych z którymś z poniższych punktó
191191

192192
Wchodzimy na naszą tablice zadań i przypisujemy się do zadania sygnalizując, że zgłaszamy się do jego zrobienia:
193193

194-
![zgłaszanie się do PR](../../../../assets/github/image6.png)
194+
![zgłaszanie się do PR](../../assets/github/image6.png)
195195

196196
### Rozpoczęcie pracy nad zadaniem
197197

@@ -212,13 +212,13 @@ Wchodzimy na naszą tablice zadań i przypisujemy się do zadania sygnalizując
212212
1. Gdy jesteśmy gotowi, zmieniamy status taska na **In Review** (jeśli taki status jest w projekcie).
213213
2. Tworzymy pull requesta z naszego brancha na branch **main** lub **dev** (jeśli aplikacja na main jest już opublikowaną wersją produkcyjną).
214214

215-
![przycisk otwórz PR](../../../../assets/github/image7.png)
215+
![przycisk otwórz PR](../../assets/github/image7.png)
216216

217217
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).
218218
4. Można oznaczyć swojego techleada jako reviewer (opcjonalne).
219219
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.
220220

221-
![dodawanie issues do PR](../../../../assets/github/image4.png)
221+
![dodawanie issues do PR](../../assets/github/image4.png)
222222

223223
6. Oczekujemy na code review od naszego techleada.
224224
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
280280

281281
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 🙂🙃🙂
282282

283-
![Podpis Szymona Kowalińskiego](../../../../assets/github/image10.png)
283+
![Podpis Szymona Kowalińskiego](../../assets/github/image10.png)
284284
**Wiceprezes VII Zarządu KN Solvro**

src/content/docs/hello-there.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -46,8 +46,8 @@ Znając [wstępne informacje](#na-początek) o naszej dokumentacji, chcielibyśm
4646
Ogólne informacje:
4747

4848
- [Zapoznaj się z naszą strategią](/solvro/strategy)
49-
- [Kanały komunikacji](/sections/management/communication-channels)
50-
- [Jak używać GitHuba?](/sections/management/github)
49+
- [Kanały komunikacji](/communication)
50+
- [Jak używać GitHuba?](/github)
5151
- [Jak prowadzimy projekty? Czego się spodziewać?](/sections/management/prowadzenie-projektów/)
5252
- [Poznaj nasz zarząd](/solvro/vii_board)
5353

src/content/docs/index.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -153,7 +153,7 @@ Oprócz spotkań weekly całego koła odbywają się cykliczne spotkania projekt
153153

154154
Po restrukturyzacji kierujemy się w stronę GiTHuba. Chcemy, aby był on sercem naszej organizacji, gdzie przepływa cała praca operacyjna i kod. Tam również prowadzone są projekty od strony operacyjnej, rozpisywane zadania itd. Końcowo będąc studenckim kołem chcemy chwalić się naszymi projektami i w tym właśnie celu projekty koła, które na to pozwalają będą realizowane jako open-source. Pozwoli to uhonorować członków projektu i potwierdzić swoje doświadczenie przy szukaniu pracy. Z tego również powodu dbamy o dobre praktyki pisania kodu i pracowania z githubem (PR, jednolite commity, readme itd.). Dla początkujących na naszym blogu znajduje się post [Podstawy GITa](https://solvro.pwr.edu.pl/blog/solvro-talks-1-podstawy-gita).
155155

156-
Must-have lekturą jest również [Handbook Githuba](/sections/management/github/)
156+
Must-have lekturą jest również [Handbook Githuba](/github)
157157

158158
# Projekty
159159

src/content/docs/sections/Backend/Adonis.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ description: Szybki start dla tych, którzy chcą poznać Adonisa i tworzyć św
1818

1919
Oto lista najważniejszych rzeczy, które warto w mniejszym lub większym stopniu ogarniać biorąc się za naukę korzystania z Adonisa:
2020

21-
- **Git i GitHub** - podstawowe narzędzia pracy każdego developera. Z zasadami korzystania stosowanymi w Solvro można zapoznać się w [Handbook GitHub](/sections/management/github)
21+
- **Git i GitHub** - podstawowe narzędzia pracy każdego developera. Z zasadami korzystania stosowanymi w Solvro można zapoznać się w [Handbook GitHub](/github)
2222
- **IDE** - środowisko do pracy z kodem. Do najpopularniejszych opcji należy Visual Studio Code i Webstorm od Jetbrains.
2323
- **TypeScript** - jest to podstawowy język wykorzystywany przez Adonisa. Bez jego znajomości ciężko cokolwiek zrobić.
2424
- **NodeJS** - technologia pozwalająca na uruchamianie JS poza przeglądarką. Wykorzystywana do budowania backendu. Zrozumienie działania importów i menadżera pakietów NPM jest potrzebne do sprawnego poruszania się po frameworku.

src/content/docs/sections/Management/Prowadzenie projektów.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -91,7 +91,7 @@ Lead jest odpowiedzialny za jego utworzenie, odpowiednie skonfigurowanie pól i
9191

9292
Pamiętajmy o jak najbardziej pomocnych opisach zadań najlepiej od razu z linkami/screenami do makiety UI/UX.
9393

94-
Więcej informacji można znaleźć w [Handbooku Githuba](/sections/management/github/)
94+
Więcej informacji można znaleźć w [Handbooku Githuba](/github)
9595

9696
### Makiety UI/UX
9797

0 commit comments

Comments
 (0)