Dobry github

pytanie zadane 13 maja 2018 w Rozwój zawodowy, nauka, praca przez Android1997 Nowicjusz (150 p.)

Czym powinien się charakteryzować dobry (zachęcający rekruterów) profil na przykładowo githubie? Jak powinny być opisane repozytoria, projekty, czy ilość commitów ma znaczenie ;) ?

Jeśli znalazł by się ktoś mający czas i chęci, mogący przejrzeć profil i wskazać co możnaby poprawić byłbym wdzięczny!

https://github.com/stahu112

1 odpowiedź

odpowiedź 13 maja 2018 przez adas94 Nałogowiec (29,200 p.)
edycja 13 maja 2018 przez adas94

1. Powinien zawierać wyselekcjonowane najlepsze projekty. (Starannie napisane)

2. Projekty powinny być ukończone, bądź w jakimś stabilnym stadium. (W skrócie - działające)

3. README jest idealnym miejscem do opisania jakie funkcjonalności posiada projekt, jak go uruchomić, w jakich technologiach jest napisany. Możesz tutaj się pochwalić użytym jakimś wzorcem projektowym i tego typu rzeczami. Może dorzucić do tego jakiś UML, USE-CASE czy schemat bazy danych (mini dokumentacja)

4. Commity powinny być rozdzielone ze względu na to co zostało zmienione, a także dobrze opisane. (Żadne hhee itd. Jak to u ciebie widziałem)

5. Commity powinny być pisane w jednym języku (Widziałem różnie to u ciebie jest)

To takie podstawy dzięki którym github stanie się bardziej przejrzysty dla potencjalnych rekruterów.

Najważniejsza jest oczywiście jakość samego kodu, natomiast jestem przekonany, że bez powyższych punktów twój github po prostu zostanie pobieżnie oglądnięty przez 5 sekund i wyłączony i nikt się o tym cudownym kodzie nawet nie dowie, bo mu się nie będzie chciało w bałaganie grzebać.