Size: a a a

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

2020 February 12

BG

Bogdan (SirEdvin) Gladyshev in DocOps-сообщество
Lana
Можно у нас, я договорюсь, человек 60-70 вместимость. Москва-сити. У кого есть интересные кейсы настойки генерации диаграмм из разметки или подобного? Пишите в личку.
Plantuml!)
источник

L

Lana in DocOps-сообщество
да все, что угодно DOT, PlantUML, mermaid, gnuplot, graphviz! несите всё!
источник

NV

Nick Volynkin in DocOps-сообщество
источник

BG

Bogdan (SirEdvin) Gladyshev in DocOps-сообщество
Илья Улеско
- Рассмотрим один из любимых аргументов докопсеров про гит и версионирование, а конкретно момент про диффы. Допустим, есть пара версий диаграммы, разница между которыми в паре отсутствующих элементов. Неужели только по текстовому диффу будет легче понять, как именно перестроились связи и позиции других элементов? Полагаю, что будет проще положить в гит сами изображения, и при задаче сравнения смотреть уже их — глазом практически сразу видны все необходимые изменения и следствия из них.
- Насчёт оформления: если нужно задать порядок, сгруппировать визуально элементы или использовать другие способы улучшения восприятия, то как это делать кодом? И потом для проверки корректности изменений в процессе работы постоянно выполнять сборку?
- Не стоит забывать про возможные баги из-за синтаксиса, которые отсутствуют при рисовании как таковом.
На самом деле, самый разрушительный аргумент это поддержка таких диаграм. Из-за декларативного подхода в коде их куда легче поддерживать
источник

BG

Bogdan (SirEdvin) Gladyshev in DocOps-сообщество
Потому что красиво вставить маленький блок в уже существующую диаграму в том же draw.io бывает больно(
источник

RZ

Roman Zh in DocOps-сообщество
👍
источник

NV

Nick Volynkin in DocOps-сообщество
Я могу рассказать о своём опыте с документацией и технопиаром ImagineUI. Там есть как минимум один былинный провал.
источник

L

Lejbron in DocOps-сообщество
ID:
Diagram as Code for prototyping cloud system architectures
https://github.com/mingrammer/diagrams

Люблю такое
А кем нибудь из присутствующих использовался этот инструмент? Выглядит огненно, но сложно представить насколько проще/сложнее становится поддерживать диаграммы в актуальном состоянии.  
Думаю о применении для составления карты сети - нет возможности запустить в инфраструктуру софтину, которая будет собирать всю инфу сама, нужен ручной инструмент с адекватным процессом поддержания актуальности (тоже руками соответсвенно).
источник

NV

Nick Volynkin in DocOps-сообщество
Lejbron
А кем нибудь из присутствующих использовался этот инструмент? Выглядит огненно, но сложно представить насколько проще/сложнее становится поддерживать диаграммы в актуальном состоянии.  
Думаю о применении для составления карты сети - нет возможности запустить в инфраструктуру софтину, которая будет собирать всю инфу сама, нужен ручной инструмент с адекватным процессом поддержания актуальности (тоже руками соответсвенно).
Спросим автора поста. @rusdacent ты уже успел заюзать?
источник

ML

Maksim Lapshin in DocOps-сообщество
Илья Улеско
- Рассмотрим один из любимых аргументов докопсеров про гит и версионирование, а конкретно момент про диффы. Допустим, есть пара версий диаграммы, разница между которыми в паре отсутствующих элементов. Неужели только по текстовому диффу будет легче понять, как именно перестроились связи и позиции других элементов? Полагаю, что будет проще положить в гит сами изображения, и при задаче сравнения смотреть уже их — глазом практически сразу видны все необходимые изменения и следствия из них.
- Насчёт оформления: если нужно задать порядок, сгруппировать визуально элементы или использовать другие способы улучшения восприятия, то как это делать кодом? И потом для проверки корректности изменений в процессе работы постоянно выполнять сборку?
- Не стоит забывать про возможные баги из-за синтаксиса, которые отсутствуют при рисовании как таковом.
> только по текстовому диффу будет легче понять,

не так. Только текстовый дифф дает возможность понять разницу

> будет проще положить в гит сами изображения

да, положить проще

> глазом практически сразу видны все необходимые изменения

А вот это конечно нет, особенно на мелких картинках.

Я сейчас делаю железо, в нём на одной плате 16 тыс связей. Инструментарий прямо скажем убогенький
источник

NV

Nick Volynkin in DocOps-сообщество
Вот что, как насчёт онлайновой мини-конференции?
источник

NV

Nick Volynkin in DocOps-сообщество
Maksim Lapshin
> только по текстовому диффу будет легче понять,

не так. Только текстовый дифф дает возможность понять разницу

> будет проще положить в гит сами изображения

да, положить проще

> глазом практически сразу видны все необходимые изменения

А вот это конечно нет, особенно на мелких картинках.

Я сейчас делаю железо, в нём на одной плате 16 тыс связей. Инструментарий прямо скажем убогенький
Максим, а что если бы связи на плате описывались синтаксисом языка программирования, как в примере выше? Тогда можно было бы использовать средства самого языка для проверки логики-связности-прочего, да и для моделирования. Что ты об этом думаешь?
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Nick Volynkin
Максим, а что если бы связи на плате описывались синтаксисом языка программирования, как в примере выше? Тогда можно было бы использовать средства самого языка для проверки логики-связности-прочего, да и для моделирования. Что ты об этом думаешь?
Verilog так и работает же
источник

NV

Nick Volynkin in DocOps-сообщество
Внезапно, Hardware Description Languages, тысячи их! Вот на пайтоне: https://github.com/cornell-brg/pymtl3
источник

ML

Maksim Lapshin in DocOps-сообщество
Nick Volynkin
Максим, а что если бы связи на плате описывались синтаксисом языка программирования, как в примере выше? Тогда можно было бы использовать средства самого языка для проверки логики-связности-прочего, да и для моделирования. Что ты об этом думаешь?
конечно разумнее было бы.

Проблема с визуальными инструментами в том, что в них смешивается логическая связь и графическое представление.

Например, мне существенно то, что ножка A45 процессора через  резистор 10Ком соединена с ножкой 32 микроконтроллера.

То, как именно проходит линия на картинке не имеет значения.

Сравнивать картинки означает погрязнуть в автоперекладываниях этих линий
источник

AY

Andrei Yemelianov in DocOps-сообщество
Знатоки Help and Manual в чате есть?
источник

NV

Nick Volynkin in DocOps-сообщество
Вот кажется @Mokrushin_AI разбирается.
источник

А

Александр Мокрушин in DocOps-сообщество
я долгое время работал с HM
источник

AR

Anna Ryutina in DocOps-сообщество
Andrei Yemelianov
Знатоки Help and Manual в чате есть?
есть немного
источник

ИУ

Илья Улеско in DocOps-сообщество
Bogdan (SirEdvin) Gladyshev
На самом деле, самый разрушительный аргумент это поддержка таких диаграм. Из-за декларативного подхода в коде их куда легче поддерживать
В целом соглашусь с тем, что сложности бывают. Но тут скорее зависит от инструментария и типа диаграммы. Например, добавление новых блоков в BPMN-диаграмму процесса в Camunda не вызывает проблем — есть механизмы для поддержки всех смещений. С draw.io давно не работал.
источник