Czytelność kodu

Przeglądając strony o programowaniu trafiłem na taką ciekawą stronę, gdzie autor Ramarao Kanneganti opowiada jak pisać czytelny kod, który każdy inny może przeczytać i zrozumieć łatwo:

http://www.kanneganti.com/technical/readable-code

A może podejść odwrotnie do tematu i znaleźć takie sposoby pisania kodu których trzeba unikać?

Dla mnie podejrzane są na przykład takie konstrukcje:

[Kod C#]
is_readable ? read() : {is_writeable ? write() : MessageBox(“Error”)}

albo:

[Kod C#]
if (is_readable)
{
(…80 linii kodu)
if (is_writeable)
{
(…80 linii kodu)
}
(…80 linii kodu)
}

Takie warunki ciągnące się przez kilka stron kodu powodują, że się robi całkowicie nieczytelny i trudny do utrzymania, modyfikacji.

Tak samo linie kodu, które są dłuższe niż szerokość ekranu.

Albo kod bez komentarzy. W.w. autor postuluje, że komentowanie każdej linii kodu jest bez sensu i z tym się zgadzam. Natomiast np. blok kodu który w gruncie rzeczy robi jedną rzecz już według mnie powinien być opisany, tym bardziej, jeżeli sposób działania tego bloku może być nieczytelny (jak w pierwszym przykładzie kodu).

Czasem programiści postulują też, że podejście obiektowe na tyle zwiększa czytelność kodu, że metody i właściwości publiczne nie wymagają opisu, posuwając się nawet do tego, że wewnętrzne mechanizmy klasy też nie są opisane.

Przeczytaj też

Kurs programowania w C# i wszystkie inne zasoby Wszystkie informacje jakie musisz znać, żeby programować w C#. Poniżej znajdziesz listę wszystkich potrzebnych zasobów związanych z programowan...
Dlaczego nie zgłaszam już błędów Microsoftowi W trakcie korzystania z pakietu programistycznego Visual Studio od Microsoftu zdarzyło mi się znaleźć parę błędów w ich oprogramowaniu. Wbrew namowom ...
Dwie rzeczy, które warto wiedzieć o serializacji w... Serializacja w C# to nie tylko dodanie atrybutu Serializable. Serializacja do postaci binarnej czyli: IFormatter formatter = new BinaryFormatter()...
Nowe CodeGuru – nareszcie! Od marca 3 podejście do nowej wersji strony CodeGuru dla programistów związanych z technologiami Microsoftu znajdowało się w wersji beta. Dzisiaj szcz...
Język C# 2008 i platforma .NET 3.5 Tytuł: Język C# 2008 i platforma .NET 3.5 Autor: Andrew Troelsen Język: Polski (tłumaczenie) We wrześniu 2008 pisałem o 2 wydaniu książki "Ję...
Czytaj podobne  Instalacja VS 2008 i .NET 3.5 SP 1 Beta
Napisano w Desktop Tagi: , , , , , , , , , , , , , , , ,