Size: a a a

DocOps-сообщество

2018 October 11

V

Vlad [Krd] in DocOps-сообщество
А если вернуться именно к докам - кто какими средствами для диаграмм (различных) пользуется? Сами сейчас подсаживаемся на draw.io - бесплатно, доступно, в целом удобно, не нужно ставить левое ПО. Из минусов что html не отображается нормально в confluence - приходится прикладывать в статью и png для отображения, и html для редактирования(его плюс в том что его и просто открыть можно)
источник

NV

Nick Volynkin in DocOps-сообщество
PlantUML хорош для диаграмм
источник

NV

Nick Volynkin in DocOps-сообщество
Вот @nmpotashnikoff про него писал статью: https://t.me/docops/65
источник

NV

Nick Volynkin in DocOps-сообщество
А ещё, я знаю, @SuckMyNuts умеет в диаграммы.
источник

НН

Нац Нац in DocOps-сообщество
Мы вот на днях недавно к mermaid пришли в итоге, всем очень нравится, если хватит элементов
источник

V

Vlad [Krd] in DocOps-сообщество
А draw.io не пробовали? Может сразу есть чем сравнить?
источник

НН

Нац Нац in DocOps-сообщество
Пробовали, все зависит от того, что тебе нужно в итоге
источник

НН

Нац Нац in DocOps-сообщество
Нам нужно было версионировать графики
источник

НН

Нац Нац in DocOps-сообщество
Видеть изменения в них И так далее, чтобы апдейтить  доки
источник

НН

Нац Нац in DocOps-сообщество
Если такого не нужно, то drawio очень даже ок, в svg экспортит и круто
источник

V

Vlad [Krd] in DocOps-сообщество
Нац Нац
Нам нужно было версионировать графики
Вряд ли кто-то оценит кроме меня))) важнее наглядность, встроить в confluence. Документирование не на таком потоке чтоб отслеживать изменения
источник

НН

Нац Нац in DocOps-сообщество
У нас просто такой, живой проект, мы частично и есть заказчики, поэтому все в активной разработке и чтобы новые девелоперы могли быстро подключиться и понять как все работает, для них нужные свежие и очень актуальные доки, вот и версионируем. Тогда да, drawio подойдет, мы на нем делали первые версии и все были довольны
источник

ЕР

Екатерина Рудская in DocOps-сообщество
У нас под Confluence использовались по очереди несколько шаблонов.
Gliffy удобный, но часть диаграмм через какое-то время бьётся. Восстановить не удалось.
Потом был draw.io. Не понравился аналитикам, постоянно просто так размножал объекты.
А сейчас LucidChart. Платный, но удобный. UML поддерживает, схемы поддерживает, версионность есть (удобно), экспорт в SVG есть. Ещё есть слои и страницы, в некоторых случаях это шикарно.
источник

V

Vlad [Krd] in DocOps-сообщество
Я пробовал бесплатно lucidchart, но дро.ио показался удобнее.

Вообще подозреваю что если документирование встанет хорошо на поток потом и версионность захочется
источник

NV

Nick Volynkin in DocOps-сообщество
Vlad [Krd]
А направили меня сюда вот с этим вопросом
А кто вас сюда направил?
источник

OI

Olga Ilchukova in DocOps-сообщество
(спросил Ник, направив лампу в глаза)
источник

OI

Olga Ilchukova in DocOps-сообщество
Привет!
источник

NV

Nick Volynkin in DocOps-сообщество
Olga Ilchukova
(спросил Ник, направив лампу в глаза)
Мне интересно, кого мне поблагодарить за рекомендацию )))
источник

LZ

Lev Zabudko in DocOps-сообщество
Привеет :) в чате тимлидов запостили ссылку на вас. Я продакт и вопрос документирования достаточно острый)
источник

LZ

Lev Zabudko in DocOps-сообщество
Зайдите в @docsascode
источник