отдельным разделом "негативные кейсы" )

диаграммы бизнес-процессов пользователи обычно хорошо понимают

Мы разбиваем по сценариям...
То есть Сценарий 1 "Бычок идет из точки а в точку б успешно".
Сценарий 2. "Бычок идет из точки а в точку б, но на развилке свернул в точку с".

Выходит, конечно, дофига сценариев, но пока возражений особо не поступало.

Да, вот это с основным и альтернативными сценариями тоже пробовали, и тоже не понравилось (  Потому что каждый альтернативный ведь тоже ветвится несколько раз. В итоге - взрыв мозга.

Это да((
Но мы в некоторых случаях используем подсценарии... "Свернул влево" и "свернул вправо" без описания от отправной точки...

Не панацея, конечно, но...любые графические изображения именно в мт запрещены у нас...

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

А что, какой-то семинар состоялся с анонсированием группы, что столько вновь прибывших?

Скорее всего в ЦНТИ Прогресс

Добрый вечер!

Хочу рассказать о том, как у меня сложилась работа с описанием API методов в Confluence для постановки задачи на их реализацию разработчикам (структура страниц в confluence, структура заголовков, некоторая автоматизация, описание интерфейса метода и работы логики под капотом).

Время и дата: 18:00 16.02.21 (вторник).

Будет пара примеров, которые можно будет использовать как "рыбу".
Залью это дело на ютуб, так что кому надо, тот сможет посмотреть задним числом.
Но в целом я не претендую на то, что это "единственно верный метод описания", для вас это будет один из вариантов, как люди работают в других компаниях. Можно будет что-то почерпнуть для себя.

В общем, возьму лампу, кота и буду рассказывать. xD

Ссылка и id конференции:
https://us04web.zoom.us/j/75989849812?pwd=Q2Mra0thdi9EL0JYUVFDVUcwU1kyUT09
Идентификатор конференции: 759 8984 9812

Если вдруг кому интересно👆

Больше всего интересно, зачем именно в конфлюенсе, когда есть специализированные инструменты. )

Ну и в целом интересно, жаль только что поздно узнали )

Может быть человек в Atlassian работает, и там речь об API самой конфы?

Интрига!

Всем привет) поделюсь своим опытом: я описывала API на вики для внутренних сервисов, которыми пользуются другие команды разработки внутри компании. Уже была привычка у разработчиков частично писать и читать доку на вики. сваггер был только для некоторых сервисов, но там всех подробностей не уместишь, и подключение и описание для всех сервисов вышло бы дороже, чем сесть и написать. а описание тех же параметров не так важно, как условия их использования или алгоритмы для легаси сервисов, где в коде черт ногу сломит (но по правде это всего два таких).

Тут Бох писанины вещает в клабхаусе. Залетайте.

Как туда попасть? Вы можете пригласить?