Uwaga! Trwają prace nad nową wersją serwisu. Mogą występować przejściowe problemy z jego funkcjonowaniem. Przepraszam za niedogodności!
🏆 Lubisz podcast Pierwsze kroki w IT? Oddaj swój głos w rankingu: TOP 10 polskich podcastów o IT! 🏆
Dwa kroki i gotowe! Dzięki temu artykułowi stworzysz README profilowe, nawet jeśli nie wiesz jeszcze, czym jest Git. Nie musisz niczego instalować. Wystarczy przeglądarka i pomysł na tekst o sobie – na końcu artykułu znajdziesz garść inspiracji.
Rozszerzenie .md przeznaczone jest dla plików tekstowych, w których treść formatowana jest za pomocą tzw. Markdownu. Markdown, podobnie jak HTML, jest językiem znaczników.
Zastosowanie odpowiedniego znacznika daje nam konkretny efekt w postaci sformatowanego tekstu. Weźmy np. zapis **tekst**. Znacznikiem są tu dwie gwiazdki, a efektem – pogrubiony tekst.
Jeśli chcesz przed rozpoczęciem uzupełniania profilu lepiej poznać GitHuba, przeczytaj artykuł o tym, czym jest GitHub i do czego służy.
Zaloguj się na swoje konto na GitHubie. Być może już wtedy zobaczysz propozycję uzupełnienia profilu o README. Wygląda ona jak na screenie poniżej.
Wówczas wystarczy kliknąć „Continue”. Zostaniemy przeniesieni bezpośrednio do edycji pliku README.md w nowo utworzonym repozytorium. Nazwa tego repo będzie identyczna jak nazwa naszego profilu. Jeśli idziesz tą drogą, przejdź od razu do kroku 2 🙂
Jeśli nie wyświetla Ci się powyższe okienko, to takie repozytorium musisz utworzyć sam:
Gratulacje, masz już README profilowe! 😉
Teraz kliknij “Edit README” lub ikonę ołówka i do dzieła!
Plik README.md możemy z poziomu GitHuba wygodnie edytować, a wprowadzone zmiany zatwierdzać (commitować). Tryb edycji wygląda jak poniżej:
Czas skorzystać z Markdownu. By dowiedzieć się, jak tworzyć nagłówki, listy, cytaty, zamieszczać linki, obrazy czy fragmenty kodu możesz zajrzeć do ściągi GitHuba z Markdownu.
Najwygodniej jest otworzyć sobie narzędzie przeznaczone do edycji plików .md, np. StackEdit. Z lewej strony będziesz mieć treść ze znacznikami, a z prawej – efekt końcowy formatowania.
U mnie wygląda to tak:
Kiedy opis jest już gotowy, wystarczy wkleić treść w Markdownie do edytowanego pliku README.md. Jeśli chcesz się upewnić, że wszystko wyświetli się prawidłowo, kliknij przycisk „Preview”.
Czas wprowadzić (commitować) zmianę w README.md. My dodajemy opis profilu, dlatego adekwatnie do tego nazwałem commita: „add profile description”. Możesz oczywiście wpisać jakąkolwiek inną nazwę.
Commitujemy do gałęzi main (zaznaczona opcja) i zatwierdzamy zmianę, klikając „Commit changes”.
Gotowe! Zmiany zostały zatwierdzone. Czas udać się na stronę główną swojego profilu, by zobaczyć efekt końcowy. Oto on:
Chcesz dokonać poprawek? Kliknij ikonę ołówka. Dalej zasady są takie same: edytujemy, wpisujemy nazwę commita, zatwierdzamy 🙂
Przykłady minimalistycznych opisowych README profilowych zamieszczam poniżej:
Spodobał Ci się jakiś element, ale nie wiesz, jak go użyć u siebie? Wejdź w plik README.md w repozytorium o nazwie profilu, który przeglądasz, i wybierz „Raw”. Wyświetli Ci się treść w Markdownie. Najczęściej wystarczy zwykłe kopiuj-wklej! 😉
W pierwszej kolejności zastanów się, czy już gdzieś nie masz takiego opisu. Może na LinkedIn, w CV, na jakimś forum, na własnym blogu? Jeśli tak, to nie ma sensu się powtarzać!
A jeśli nie, to podrzucam „przepis” na krótkie README (oczywiście nie jest to jedyny słuszny schemat! 😉 ).
U GÓRY
Napisz 1-3 zdania o sobie:
Nie rozpisuj się, bo stworzysz odpychającą ścianę tekstu! 🙂
W ŚRODKU
Wypunktuj języki programowania i narzędzia, które znasz. Jeśli jest tego niewiele, nie wymyślaj na siłę. Nie chwal się też wszystkim, czego kiedykolwiek spróbowałeś. Cała masa języków i narzędzi będzie wyglądać podejrzanie.
Wybierz to, w czym wykonałeś już przynajmniej jeden projekt, który mógłbyś pokazać rekruterowi.
Jeśli dopiero zaczynasz programować, po prostu pomiń ten punkt. Uzupełnisz go później.
Wymień po 3 (nie więcej, bo nikomu się nie będzie chciało tego czytać 😀 ) rzeczy spośród:
Mały tip: warto pisać szczegółowo, bo szczegóły działają na wyobraźnię! Przykładowo słowo “sport” jest zbyt ogólne. Lepsze będzie “poranne bieganie z moim psem 🐕” albo “trenuję na siłowni, by wycisnąć 100 kg 💪”. Takie podejście przyda Ci się także przy tworzeniu CV czy rozmowach rekrutacyjnych.
NA KOŃCU
Możesz ten punkt pominąć (wówczas ulubione zajęcia będą ostatnią “sekcją”) lub wstawić np. motto czy cytat, który dobrze określa Twoje podejście do ludzi, pracy, programowania itp.
Jest to także dobre miejsce na podlinkowanie np. swojej strony internetowej (możesz to zrobić również pod zdjęciem profilowym), portfolio czy profilu na LinkedInie.
Istnieje pewne repozytorium, w którym znajdziesz ogrom przykładów, artykułów i narzędzi do podrasowania README profilowego.
Jeśli jednak jesteś początkującym programistą, radzę nie zagłębiać się zanadto w gify, latające gwiazdki i statystyki konta. Prawdopodobnie masz sporo pilniejszych tematów, którymi trzeba się zająć! 😉
W ramach udoskonalania profilu możesz zacząć od wyświetlenia statystyk swojej aktywności na GitHubie. Oto kilka gotowych rozwiązań, które to umożliwiają:
Stworzenie README profilowego sprawi, że będziesz o krok bliżej do swojego celu – oczywiście jeśli tym celem jest otrzymanie lub zmiana pracy w IT 😉 README to także dobre miejsce, by przekierować odwiedzających do innych mediów, w których dzielisz się wiedzą. Jeśli więc prowadzisz bloga, vloga czy wysyłasz wartościowy newsletter, nie zapomnij go podlinkować!
Udostępnij ten artykuł:
Zapisz się i zgarnij za darmo e-book o wartości 39 zł: Jak zostać programistą? Skuteczny przewodnik!
Jak zostać programistą? Skuteczny przewodnik
TERAZ DOSTĘPNY BEZPŁATNIE!
Cena w sklepie to 39 zł, a Ty możesz otrzymać ten e-book bezpłatnie za zapis na newsletter. To ponad 40 stron konkretów o nauce programowania i pracy w IT.