Посмотрите на две версии одной и той же архитектурной диаграммы. Одна безупречна: идеально прямые линии, блоки выровнены по сетке, одинаковые углы. Другая выглядит как диаграмма в стиле от руки: штрихи чуть небрежные, будто кто-то набросал её на доске пять минут назад. А теперь честно ответьте себе на вопрос. На какой из них вы спокойно стали бы что-то черкать?
Почти все указывают на набросок. Этот инстинкт не случаен, и он говорит кое-что важное о том, как техническую документацию на самом деле используют, игнорируют или тихо забрасывают.
Психология лоска
Жёсткая, идеальная до пикселя диаграмма несёт скрытый посыл: это готово. Каждая линия проведена намеренно, каждый блок стоит на своём месте, кто-то явно потратил немало сил, чтобы всё выглядело официально. А готовое не приглашает к правкам. Оно приглашает кивнуть. Когда диаграмма выглядит так, будто только что вышла из типографии, сомневаться в ней кажется сродни порче памятника, поэтому человек, заметивший пропущенную очередь или неверную стрелку, просто молчит.
Рисованный вид действует наоборот. Он воспринимается как работа в процессе, общий набросок, а не заявление. Именно этот пониженный порог и важен. Люди тычут пальцем в грубый рисунок, обводят то, что выглядит неправильно, и говорят: "погодите, разве кэш теперь не здесь?" Несовершенство становится приглашением.
Диаграмму, которая выглядит незаконченной, исправляют. Диаграмму, которая выглядит законченной, игнорируют.
Внимание уходит на идею, а не на пиксели
Есть и второе, менее заметное преимущество. Когда диаграмма должна выглядеть аккуратно, её автор начинает возиться не с тем: выровнен ли этот блок по тому, одинаковы ли отступы, почему эта стрелка съехала на пиксель. Эта возня облагает мышление налогом. Она отвлекает от настоящего вопроса: правильно ли блоки и стрелки описывают систему.
Стиль от руки этот налог снимает. Никто не ждёт от наброска идеального выравнивания, поэтому никто не тратит двадцать минут на подталкивание прямоугольников. Энергия остаётся на идеях и связях между ними. И раз рисунок делается быстро и без особых ставок, ранняя диаграмма действительно появляется, а не остаётся тем, что вы всё собираетесь сделать, "когда будет время сделать красиво".
- Грубые наброски делаются быстро, поэтому появляются в начале проектирования, когда пользы от них больше всего.
- Низкие ставки означают, что набросок проще выбросить и перерисовать, чем защищать уже вложенные усилия.
- Раз их дёшево создавать, их дёшево и поддерживать в актуальном виде, а это единственный способ сохранить диаграмму правдивой.
Вот настоящая причина, по которой инструмент для диаграмм с уклоном в рисованный стиль обычно порождает больше документации, а не меньше. Большинство диаграмм убивает барьер на старте, а лоск и есть барьер, замаскированный под достоинство.
Пусть рисунок объясняет сам себя
Картинка прекрасно отвечает на вопрос "что с чем связано" и совсем не отвечает на вопрос "почему". Обычно именно здесь диаграммы и их описания расходятся: рисунок лежит в одном месте, поясняющий абзац в другом, и стареют они с разной скоростью.
LetDraw закрывает этот разрыв функцией Объяснить диаграмму. Укажите ей на рисунок, и она превратит фигуры и связи в понятный текст или Markdown: письменное описание системы, которое совпадает с картинкой, потому что создано из неё. Диаграмма может выходить вместе с собственным описанием, и документ с рисунком остаются двумя видами одного целого, а не двумя вещами, которые противоречат друг другу.
Скетч-диаграммы: небрежность намеренная
Всё это не аргумент против аккуратности. Это аргумент о том, когда лоск помогает, а когда вредит. На ранней стадии, пока дизайн ещё мягкий и вам нужно, чтобы люди спорили, набросок вызывает тот самый спор, который делает дизайн лучше. Позже, когда решение принято и вы передаёте его аудитору или новому сотруднику, чёткость как раз уместна, и до неё один переключатель.
Лучшая техническая документация та, которую читают, ставят под сомнение и поддерживают в актуальном состоянии. Чаще всего это та, что выглядит немного нарисованной от руки, потому что она всё ещё словно просит вашей помощи. Откройте холст, сначала набросайте черновую версию, а лоск диаграмма пусть заслужит позже.