Комментарии 9
Почему на примере UML, в разделе "Backend и Frontend разработчикам", красная метка "Негативный сценарий: Токен невалиден" располагается рядом с блоком "alt [Оплата успешна]" ?
При работе с иностранным вендором в условиях сложных изменений интеграции я использовал визуальные схемы формата 'As Is' и 'To Be'. Создавал их через скриншоты в Paint — это оказалось быстрым и эффективным способом коммуникации.
Не соглашусь, что диаграмма так всё просто решает. Зачастую на диакрамме ничего не понятно, даже если всё верно нарисованно. Текст обязателен всегда! И он работает лучше. А кто не любит читать, тот извини.
Текст всегда останется основой для точных требований, и я не утверждаю, что диаграммы его заменяют. Однако их ценность — в сокращении времени на понимание и снижении ошибок. Этот тезис раскрыт под темой “Баланс — это как пицца: без правильных пропорций невкусно”
Текст незаменим для сложных технических деталей, но без диаграмм команда тратит больше времени на расшифровку логики.
Идеальная комбинация: диаграмма как «карта», текст как «инструкция».
Сухие факты + примеры из статьи + акцент на synergy, а не замену.
Да-да. Считаю, что диаграммы переоценены, особенно BPMN.
Сталкивался по работе с диаграммой высотой в 3 экрана и шириной еще во столько же, ничего в ней понятно, в отличие от текстового пояснения.
А есть инструмент в чем можно так красиво описать как в "Описание REST API с указанием endpoints и параметров"?
https://editor.swagger.io/
Swagger — это сейчас, самый популярный способ описать API.
Ну а если хочешь красивую спецификацию, как в примере, то это, я делал в Яндекс.Вики — у них там удобный редактор.
Хотя вообще-то неважно, где писать. Можно хоть в Word’е набросать, но тогда придётся возиться со стилями (но это только для таких педантов, как я). В примере просто использовал готовый шаблон — ничего особенного. А красиво выглядит он потому, что сам сервис симпатичный.
Swagger — классика, без него никуда.
Просто покажи: сила визуализации в аналитике