Pull to refresh

Comments 8

Татьяна скажите пожалуйста, будет ли запись вебинара? Не совсем в удобное время вебинар.

Да. Запись я направляю всем, кто зарегистрировался на указанную почту, а также выкладываю в телеграм.

Инструмент удобный, но спеку UML в ряде сценариев нарушает

Инструмент удобный, но спеку UML в ряде сценариев нарушает

Люблю Плант, но данные примеры к документированию собственно API имеют очень малое отношение. Все они либо про внутренние, либо про внешние компоненты. Про контракты, а это самое важное в API, ничего.

Автор, с какой целью понадобилось диаграммы документирования информационных систем назвать диаграммами документирования API? OpenAPI спецификация слишком сложна?

Автору респкт за короткий обзор plantuml, но заголовок статьи и правда не бъется с содержанием

Диаграммы, описанные в статье, не назывались диаграммами документирования API. Работа с API здесь - пример задачи, для которой пишется документация. А диаграммы здесь - пример того, как можно дополнить описание требований.

Использование PlantUML для документирования API — эффективный способ визуализировать систему с разных сторон

Думаю, что в заключении могла показаться некорректной данная фраза про документирование. Но здесь имеется в виду дополнение диаграммами документацию, а не чистое использование PlantUML для этого.

Спасибо за категоризацию диаграмм - почему-то ранее не задумывался, а тут все лаконично объяснено.

Для диаграммы компонентов, думаю, больше подойдет пакет C4 из стандартной библиотеки plantUML

Sign up to leave a comment.

Articles