В этой теме будут выкладываться примеры плохого кода и советы по его улучшению.
Если кто-то хочет подкинуть материалов (а у каждого, уверен, есть такие старые проекты, в которых код просто ужасный), смело кидайте, вместе поковыряем.
Рекомендовано к прочтению:
Стив Макконнелл - Совершенный Код
Совершенный код ХабраХабр
Главное правило: вы пишите код не для устройства, вы пишите его для людей! Почему? Потому что устройство работает не с кодом, а с бинарниками, и компилятору тоже не важно, как красиво вы оформляете код, а вот вы проводите над чтением/написанием кода очень много времени, поэтому упростите себе же задачу - пишите хороший код.
Основные советы по улучшению читабельности кода:
- Делайте отступы в блоках.
- Если так сложно 4 раза нажать на пробел, пользуйтесь форматированием кода в IDE (Source - Format Code), jBeautyME, http://jsbeautifier.org/ http://ctrlq.org/beautifier/
- Старайтесь давать понятные и осмысленные имена переменным, методам и классам.
- По возможности пишите комментарии в тех местах кода, которые не слишком очевидны.
Следование этим четырём советам значительно уменьшит количество ругани в ваш адрес при чтении ваших исходников.
__________________