Jak pisać kod niemodyfikowalny

Kiedyś znalazłem artykuł o programowaniu, który dość mocno wbił mi się w umysł: How To Write Unmaintainable Code.
Przez długi czas myślałem o tym jako o instrukcji „czego nie robić” napisanej w dość żartobliwy sposób. Tak było do czasu gdy zacząłem pracować w korporacji, której domeną nie jest tworzenie oprogramowania. Praca z takim kodem niestety nie jest zabawna. Poniżej kilka kwiatków, które znalazły w tej firmie zastosowanie w rzeczywistości i do dziś zastanawiam się czy specjalnie, czy też przez jakiś niewyjaśniony splot przypadkowych wydarzeń lub niewiedzę.

Dokumentuj oczywistości oraz Dokumentuj „jak” a nie „dlaczego”

W kodzie często znajduję długie historie o tym jakie program kiedyś miał założenia.
Natomiast gdy przechodzę do typowo algorytmicznych funkcji, które „coś” liczą, nie znajduję grama komentarza (tzw. „komentarze ninja” – nikt ich nie widzi).

Nigdy nie weryfikuj

„Dane jeśli są złe, to jest to wina użytkownika lub źródła danych. My nie musimy tego obsługiwać.” – naprawdę słyszałem coś takiego.

Omijaj firmowe standardy

To niewiarygodne, ale w kodzie ciągle pojawiają się nowe stałe w rodzaju:

#define K_ONE 1
#define K_TWO 2
#define K_THOUSAND 999 

Obrazek jest jak 1000 słów; funkcja ma 1000 linii

Funkcje które mają po 9 ekranów nie są czymś unikalnym.
Zastanawia tylko celowość ich tworzenia.

Zobacz również

Advertisements
Napisane w Uncategorized

Skomentuj

Wprowadź swoje dane lub kliknij jedną z tych ikon, aby się zalogować:

Logo WordPress.com

Komentujesz korzystając z konta WordPress.com. Log Out / Zmień )

Zdjęcie z Twittera

Komentujesz korzystając z konta Twitter. Log Out / Zmień )

Facebook photo

Komentujesz korzystając z konta Facebook. Log Out / Zmień )

Google+ photo

Komentujesz korzystając z konta Google+. Log Out / Zmień )

Connecting to %s

%d blogerów lubi to: