Zapachy projektu: Luźne myśli o tym, do czego dążyć w procesie tworzenia kodu

Autor, Mateusz Górski, zastanawia się nad przechodzeniem między zespołami deweloperskimi i praktykami, które odróżniają dobrze utrzymane bazy kodu od tych borykających się z problemami.

Dlaczego ten artykuł

Po dołączeniu do nowego zespołu autor zdał sobie sprawę, że praktyki wcześniej uważane za oczywiste nie są powszechne we wszystkich projektach. Zamiast potępiać istniejące podejścia, artykuł analizuje „zapachy" – sygnały ostrzegawcze warte zbadania – mające zastosowanie do deweloperów na każdym etapie kariery.

Testy

Testowanie okazuje się najważniejszą praktyką. Dobrze napisane testy służą jako żywa dokumentacja dla nowych członków zespołu. Autor kładzie nacisk na opisowe nazewnictwo testów, na przykład „test_raises_validation_error_when_incorrect_country_code_provided" zamiast ogólnych etykiet jak „test_fails".

Dodatkowe aspekty testowania obejmują rozumienie wstrzykiwania zależności dla testowalności, stosowanie do kodu testowego tych samych standardów jakości co do kodu produkcyjnego i dążenie do kompleksowego pokrycia (nawet 100% jest osiągalne). Testowanie integracyjne na wielu warstwach – walidowanie endpointów API wraz z wynikami bazy danych – zapobiega sztywnym architekturom kodu nadmiernie testującym poszczególne funkcje.

Zależności między modułami

Artykuł omawia Regułę Zależności: wewnętrzne warstwy architektoniczne nie powinny polegać na zewnętrznych. Unikanie cyklicznych importów ułatwia utrzymanie kodu. Enkapsulacja na poziomie modułu jest analogiczna do zasad na poziomie klasy.

Frameworki programistyczne

Deweloperzy powinni rozpoznawać wzorce projektowe narzucane przez ich frameworki, uznając, że standard jednego frameworka może być antywzorcem w innym.

Spotkania i SCRUM

Zbyt liczne spotkania pochłaniają zasoby. SCRUM powinien ułatwiać, a nie więzić zespoły. Szacowanie w punktach story nie są powszechnie konieczne.

Podsumowanie

Kod ostatecznie służy celom biznesowym. Podczas przeglądów deweloperzy muszą unikać założenia, że ich podejście jest jedynym słusznym.