Умные разработчики оставляют указатели в лабиринте кода
When code is a maze, smart developers make maps

Современный код всё чаще напоминает лабиринт: слабая связанность компонентов затрудняет понимание того, как всё работает вместе. Разработчики тратят больше времени на анализ, чем на изменения. Автор призывает оставлять комментарии-указатели и создавать документацию-карты, даже если они неидеальны. Он делится практическими советами: как писать полезные комментарии и делать документацию доступной, наглядной и контекстной, чтобы сэкономить время всей команды.
В большинстве случаев мы тратим гораздо больше времени на попытки понять код, чем когда-либо на внесение в него изменений.