Onboarding

Elo żeloo! Witamy nowego Fronciaka na pokładzie! W tym handbooku dowiesz się wszystkiego, co potrzebujesz do rozpoczecia pracy w Kole i w swoim projekcie.

Zanim zaczniemy, jak już pewnie zauważył*ś, sekcja Frontend ma całą swoją sekcję na niniejszych docsach. Warto się z nią zapoznać, a w szczególności z Best practices i Częste błędy & FAQ

Co najpierw?

Przede wszystkim, każdy członek Koła powinien zostać dodany na grupę na Messengerze, serwer na Discordzie i powinien dołączyć do organizacji Solvro na Githubie. Jeżeli nie ma cię na którymś z nich, odezwij się do swojego rodzica, kierownika projektu lub naszego naczelnego żelownika Bartka Gotowskiego.

GitHub

W Solvro, a w szczególności w sekcji Frontend pracujemy z kodem, więc GitHub jest najważniejszą częścią naszego workflow’u. Przede wszystkim, ustaw sobie publiczne członkostwo na naszej organizacji. Jeśli nie wiesz jak, skorzystaj z krótkiego poradnika.
Na stronie organizacji Solvro na Githubie możesz zobaczyć wszystkie nasze projekty i związane z nimi repozytoria, więc jeśli masz ochotę, rozejrzyj się i zobacz co gotujemy albo już ugotowaliśmy.

Nazewnictwo repozytoriów i commitów

Kładziemy duży nacisk na standaryzację i jednolite nazewnictwo repozytoriów i commitów, dlatego każdy przy nazywaniu commitu powinien się stosować do naszego schematu nazewnictwa, który jest świetnie opisany tutaj.

Discord

Kolejną ważną platformą, z której korzystamy w Solvro jest nasz serwer na Discordzie. Zaraz po dołączeniu do niego, pierwsze co powinien zrobić każdy nowy członek koła, to nadanie sobie roli odpowiadającej jego sekcji oraz projektowi, do którego należy. Mozna to zrobić na kanale Kanały i role, który powinien być na samej górze listy kanałów. Możesz tu też zaznaczyć które kanały chcesz widzieć, a które cię nie interesują i chcesz je schować dla siebie.

Struktura Discorda

Serwer Solvro jest podzielony na kilka grup kanałów:

• Solvro - Główny kanał dyskusyjny Main na sprawy niezwiązane z żadnym projektem, czy sekcją. Kanał random (chyba sam siebie tłumaczy).
• Sekcje - Dedykowane kanały tekstowe dla każdej sekcji.
• Other - Kanały niezwiązane z niczym innym na serwerze, ale nadal związane z kołem. Znajdziecie tu na przykład nasze kursy, czy też kanał na chwalenie sie projektami.
• Według projektu - Każdy projekt ma swoje własne kanały tekstowe, w celu organizowania wszelkich dyskusji związanych tylko z danym projektem. Jeżeli na projekt składa się kilka sekcji (np. Frontend, Backend, UI/UX), każda sekcja będzie miała też swój własny kanał, żeby nie zawalać głównego kanału projektu. Poza kanałami tekstowymi, kazdy projekt ma też kanał głosowy, na którym odbywają się wszystkie spotkania projektowe.

Pamiętajmy też, żeby dla każdej dłuższej rozmowy tworzyć osobny wątek, żeby nie zawalać kanału. Co jak co, ale czytelny kanał to dobry kanał :)

VS Code

Jak możecie się domyslić z nagłówka, do pisania kodu polecamy VS Code’a ze względu na ilość wtyczek, no i po prostu to, że większość Solvrowiczów też z niego korzysta. Dokładniejsze informacje na temat jakich wtyczek używamy znajdziecie tu.

Sekcje

Pewnie czytając ten artykuł nie raz przyszła wam do głowy taka, lub podobna myśl:

No dobra, cały czas mówicie o tych sekcjach, jakbym wiedział(a) o co chodzi.

Już tłumaczymy. Pomyśl o sekcjach jak o działach w przedsiębiorstwie. Każda z nich zajmuje się innym obszarem działania organizacji tak, żeby korzystać ze specjalizacji ich członków. Tylko że w naszym przypadku członkowie sekcji są porozrzucani między projektami.

Każdy członek sekcji, poza pracą w swoim projekcie musi w ciągu kwartału wykonać przynajmniej jedno zadanie operacyjne przydzielone przez leadera sekcji, lub wybrane samodzielnie spośród nieprzydzielonych zadań. Wykonanie danego zadania pozwala wam utrzymać status aktywnego członka KN Solvro. Tylko, co mi daje taki status? Ano, co chyba najwazniejsze, chroni was przed wyrzuceniem z koła. Poza tym pozwala wam przykładowo uczestniczyć w Walnych Zgromadzeniach i w nich głosować, czy też daje możliwość ubiegania się o wcześniejsze zapisy na zajęcia.

Co robić jak się nie wie co robić?

Krótka odpowiedź: Pytaj.

Długa odpowiedź: Napisz na kanale swojego projektu. Przedstaw problem, na który się natknąłeś. Na pewno ktoś z twojego projektu, lub nawet z zewnątrz ci pomoże. Dużo doświadczonych kolegów starszych stażem chodzi między kanałami i patrzy, czy ktoś nie potrzebuje pomocy. Więc nie bój się pytać, bo w inny sposób się nie nauczysz ;)

A co jeśli bym się chciał(a) douczyć czegoś, lub wymasterować React’a?

Well look no further! Nasz czołowy żelownik podrzucił nam świetny kurs Reacta - Epic React. Cały kurs możecie znaleźć na Dysku Google KN Solvro w folderze Wiedza/Frontend. Nie ważne, czy dopiero zaczynasz zabawę z Reactem, czy jesteś już doświadczonym wojownikiem, co już napisał niejedną nieskończoną pętle w useEffect’cie, na pewno coś z niego wyciągniesz i powiększysz swoją wiedzę na temat Reacta.

Witamy nowego Fronciaka!

Dotarłeś do końca tego artykułu! Po jego przeczytaniu powinieneś/powinnaś mieć już jakiekolwiek pojecie o działaniu koła. Oznacza to też, że możesz bez większych problemów rozpoczynać pracę w swoim projekcie! Baw się dobrze, słuchaj się Bartka, bo przepadniesz i jeszcze raz witamy w sekcji Frontend!