​​одна картина стоит тысячи слов - есть такая красивая цитата Конфуция. И хотя, как с кучей других раскрученных цитат - сказал он самом деле не то и не так, но недавно я имел возможность наглядно убедиться в верности этого принципа для сложных тем.

Есть группа людей, все понимают некую тему, и собрались, чтобы порешать наболевшие вопросы.
Но в этот раз решили начать с диаграммы, как все устроено. И хотя вроде все должны понимать одинаково, но с самого начала изображение блоков и стрелок потребовало уточнений
- э, нет! этот блок идет вперед этого
- а вот эта стрелка не туда, а сюда... хотя если точнее, то даже сюда... и она пунктирная, потому что это не обязательный шаг...
и тп

Все-таки в словах остается большой простор для домысливания и интерпретации. Понимаем ли мы под одним словом одно и тоже? Не понимаем ли наоборот одно и тоже под разными словами? Не домысливаем ли связи, где их нет? И не упускаем ли там, где они есть? Лишь лучшие тексты способны достичь той ясности, что легко дают простые блоки и стрелочки -
- однозначность списка сущностей. блок либо есть, либо нет. либо один, либо несколько.
- однозначность связей. стрелка либо идет, либо нет. либо в ту сторону, либо обратно.

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

Ни в одном случае мы не упарывались с формальными нотациями типа BPMN, UML и другими. Для ясности хватало просто обозначить блоки, их группировку и связи между ними.

Продолжительное время внедрению диаграмм в оборот препятствовало отсутствие инструмента. Word'ом мы для внутренней документации давно не пользуемся, а в wiki-подобных онлайн системах диаграмма обычно импортировалось как скриншот из другой системы - то есть править ее мог только автор, что сильно ограничивает обычные сценарии совместной работы на требованиями и дизайном. Вначале это решали плагином для draw.io. Сейчас чаша весов начинает склоняться в пользу Miro (которые Realtime Board)

Ни в коем случае, правда, не стоит полагать, что диаграмма это универсальный ключ и решит все проблемы. К примеру, когда мы делали сложный редизайн интерфейса и чтобы ничего не пропустить нарисовали схему всех переходов пользователя и выглядело все очень хорошо. В реальности однако один из переходов был, но был настолько не гладким, что пользователь тупо терялся и не понимал, где он теперь. Отловили до релиза, к счастью.

Мой совет - чертите!