Да, интересно

Так все-таки какого рода документация? Сначала было подумал что описание технического решения, но видимо все-таки нет.

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

А у вас там митапы будут? 🌚

Да, как на всех конференциях Онтико. Хочешь провести?

документация, идущая на сайт

Коллеги, буду благодарен за подсказки приемов наведения порядка с выравниванием элементов в PlantUML/Graphviz диаграммах при большом кол-ве элементов (порядка 20).
Без спецсредств plantuml творит вакханалию с расположением элементов.

в целом, решение найдено:
1) поделить совокупность блоков на регионы
2) скопоновать регионы по принципу табличной верстки
3) регион (группа объектов) это "скрытый пакет"

пример


skinparam package<<Hidden>> {
 borderColor Transparent
 fontColor Transparent
 backgroundColor Transparent
 shadowing false
 stereotypeFontColor Transparent
}


package "b01"<<Hidden>> {

'тут первая группа блоков, растет слева направо
}

package "b02"<<Hidden>> {
'тут вторая группа блоков, растет слева направо
}

'регионы компонуются сверху вниз (b02 под b01)

Вырастет ли когда-то платинум до html... =)

интересно, что в graphviz dot есть специальное ключевое слово для невидимого ребра, так же там есть возможность изменения рейтинга элемента и исключения ребра из изменения рейтинга. Это во многих случаях дает возможность указать верную раскладку элементов без лишней путаницы. В PlantUML можно накрутить рейтинг через количество знаков в стрелке. Однако этого недостаточно. Идея с прятанием элементов через  стереотипы  — отличная. Большое спасибо

Кто подскажет отличный паблик по джире

спасибо

В описании канала посмотрите ссылки, там указаны дополнительные ресурсы. Но вообще московский Atlassian User Group один из крупнейших в мире

благодарю за совет про рейтинг в стрелке

Про ключевое слово для скрытого ребра, будет примерно так:

ComponentA -[hidden]right- ComponentB
(выравнивание по горизонтали слева направо)

Хм, не знал, это очень пригодится)) еще бы найти возможность выключать стрелку из рейтингования. Впрочем, мне кажется, основная стратегия — делать настолько простые схемы, чтобы не было необходимости эксплицидно задавать раскладку

Мой маленький скромный труд☺️ Не судите слишком строго😊
https://docplace.ru/gost34/

@Nick_Volynkin Надеюсь правилами чата не запрещено давать ссылки на свои статьи)))

ещё один стандарт для дизайнеров и разработчиков пользователей документации

имхо - надо переделать

Для написания документации на программу используются две серии ГОСТов 19 и 34