👍 PlantUML — он не только про Sequence 👍

👍 Заметил как в сообществе, так и на хабре тенденцию "говорим PlantUML — подразумеваем диаграмму последовательности". Я соглашусь, что для неё Plant, пожалуй, наиболее интуитивен, да и сама диаграмма — крайне популярна (проводил опрос к докладу).

👍 Предлагаю вот так оценивать необходимость применения псевдокода для non-sequence диаграмм. Если:
▫️Картинка будет нагляднее текста или таблицы;
▫️Есть возможность что-то задокументировать за разумное время (до пары часов?) или диаграмма верстается автоматически;
▫️Диаграмму сможет воспринимать другой человек;
▫️Элементов и связей на диаграмме будет разумное количество (до 40?),

👍 То потратьте своё время на развитие компетенции в Plant'е и подарите своей доке новый артефакт. Затем снимите обратную связь, воспользовался ли кто-то схемой, или всем всё равно. Выводы сделаете сами.

👍 Лично мне приходится иногда строить диаграмму классов, чтобы сориентировать заинтересованных лиц в бизнес-контексте, не вываливая на них детали БД. А там, где есть статусная модель — UML state machine. И, конечно, простейшие Activity для алгоритмов с развилками, если это не полноценный бизнес-процесс.

👍 По моему мнению, главный фактор, негативно влияющий на популярность puml диаграмм — это авторасстановка. Иногда с ней можно побороться, но чаще всего проиграешь. В нашем сообществе можно посмотреть на реалистичные примеры таких диаграмм от участников, я же продемонстрирую наглядный пример State Machine в исполнении моего бота, а вы делитесь своими опытом в комментариях.

#мысли | Analyst Boost