Tidy First
Основная идея книги в том, что улучшение дизайна кода - это процесс последовательных изменений. Сама структура книги построена снизу-вверх. Сначала нам дают по одной главе на страницу, где показывают следующее:
- конкретный код - до
- конкретный код - после
- почему это улучшение Всё это выглядит как применение “правила бойскаута” на максималках. Зацепил какой-то код, который было трудно прочитать - поправь, чтобы стало проще. Ты можешь это сделать, потому что только что сидел и разбирался.
Дальше - выше. У нас есть не конкретные строки, а модули и их связи. Вообще, забавно что автор даёт определению дизайнеру (прим. под дизайн имеют не UI, а программирование), как создание элементов и выгодных отношений между ними (designers beneficially relate elements). Звучит абстрактно и смешно, если забыть что, в целом, software architecture как раз в этом и состоит. Собрать набор характеристик в разрезе компонент и решить стоит ли нам их связывать внутри (cohesion) или снаружи (coupling).
Третья часть была о финансовой стороне вопроса tidying/полишинга кода. Она заключается в том, что софт строится вокруг идеологии конструктора. Чем больше фичей вы можете сделать за счёт меньшего количества абстракций, тем больше денег скорее всего получится заработать с помощью такого софта. Суть tidying на уровне всей кодовой базы в том, чтобы добавлять эту optionality/modifability. Если у вас это не получилось, то скорее всего это не надо было делать.
И главное - основной вопрос по tidying/полишинг не в том как, а в том когда (more fundamental question is when).
Цитаты
- 202402121323: more fundamental question is when
- 202402121325: book-writing experience
- 202402122055: reason to delete dead code
- 202402122058: reorder code to simplify reading
- 202402181504: designers beneficially relate elements
- 202402181506: optionality makes system more valueable
- 202402191305: tidying is a reversible decisions
- 202402191307: make an internal library before extract as a service
- 202402122103: put a blank line between the parts
Задачи
- #task Обработать все выдержки из книги в рамках Zettels ⏳ 2024-03-12 ✅ 2024-03-11
- #task Написать выдержку из книги ⏳ 2024-03-19
- #task Доработать свои заметки на основе идей из книг