Культура кода — о разделе
Подборка материалов раздела Культура кода в энциклопедии Вселенная IT
Культура написания и поддержки кода
Именование, форматирование, комментарии, документация в коде и базовые принципы читаемости — практики, которые команда договаривается соблюдать каждый день.
Цикломатическая сложность и читаемость кода
Цикломатическая сложность — одна из наиболее устойчиво применяемых метрик статического анализа программного кода, призванная количественно оценивать логическую структуру исполняемого модуля.
MAPPER — модель кода и предметная область
Правило MAPPER (Model Abstract Partial Programmable Explaining Reality) — как сопоставлять реальность и код один к одному.
Анемичные модели и примитивная одержимость
Богатые объекты предметной области, value objects вместо string/int и антипаттерны DTO-оргии.
Изменяемость, побочные эффекты и неизменяемые данные
const, иммутабельность, ленивая инициализация и побочные эффекты в читаемом коде.
Декларативный код — что и как
Разделение «что» и «как», итерации, магические числа, callback hell и явные ошибки.
Условия, null и явные контракты
Меньше if и switch, отказ от null, быстрый провал и полиморфизм вместо флагов.
Связанность, глобалы и запахи модульности
Singleton, god object, shotgun surgery, feature envy и глобальное состояние — симптомы и приёмы рефакторинга.
YAGNI, быстрый провал и техдолг в коде
Мёртвый код, лишние абстракции, отключённые предупреждения и отложенный рефакторинг.
Тесты как часть культуры кода
Приватные методы, flaky-тесты, assertTrue, моки и данные — качество тестового кода и связь с разделом тестирования.
Исключения и обработка ошибок в читаемом коде
Пустые catch, исключения как goto, узкие try и сообщения для пользователя.
Культура кода — итоги
Итоги раздела «Культура кода» — FAQ и краткие ответы по теме.
Культура кода — чек-лист
Вопросы перед отправкой кода в репозиторий — именование, принципы, тесты, ревью и безопасность. Ответы ищите в статьях раздела.
Справочник тем чистого кода
Указатель запахов и тем качества кода с ссылками на статьи раздела 7.10 и смежные материалы энциклопедии.