Size: a a a

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

2019 November 23

НН

Нац Нац in DocOps-сообщество
Aleksey Akulovich
А есть где хорошее и адекватное сравнение Конфлюенса с Хьюго?
Мы у себя плотно сидим на первом, но интересно посмотреть по сторонам.
Не уверен, но что нужно от док? Текст, картинки, промежуточная точка где доку ревьювят. Всё
источник

L

Lejbron in DocOps-сообщество
Lana
Где часть два)
Будет в конце года;)
источник

NV

Nick Volynkin in DocOps-сообщество
Lana
Сильно зависит от того, что у вас уже есть, система контроля версий наверняка уже есть, какой-то ci тоже, контейнеризация вероятно тоже, идея же в том, чтобы использовать для документации то, в чем у вас уже экспертиза
Вот с этим полностью согласен
источник

S

Sylvestr in DocOps-сообщество
Благодарю
источник

AA

Aleksey Akulovich in DocOps-сообщество
Нац Нац
Не уверен, но что нужно от док? Текст, картинки, промежуточная точка где доку ревьювят. Всё
А, если речь про этот гошный проект, то не важно. Я думал есть что-то одноименное.
источник

NV

Nick Volynkin in DocOps-сообщество
Aleksey Akulovich
А есть где хорошее и адекватное сравнение Конфлюенса с Хьюго?
Мы у себя плотно сидим на первом, но интересно посмотреть по сторонам.
Вы его используете для внешней пользовательской документации или для внутренней между разработчиками?
источник

AA

Aleksey Akulovich in DocOps-сообщество
Nick Volynkin
Вы его используете для внешней пользовательской документации или для внутренней между разработчиками?
Для внутренней. И там уже огого понаписали.
источник
2019 November 26

NV

Nick Volynkin in DocOps-сообщество
Я наконец взялся за статью, которая https://t.me/docops/388. Ки пятнице допишу черновик. Волнуюсь, что будет одновременно непонятно, слишком банально и вообще не про то. Кто хочет поревьюить?
источник
2019 November 27

AY

Andrei Yemelianov in DocOps-сообщество
всем привет
источник

AY

Andrei Yemelianov in DocOps-сообщество
я тут разгребаю legacy, и нашёл один репозиторий с документацией
источник

AY

Andrei Yemelianov in DocOps-сообщество
там есть XML-диаграммы в файлах с расширением .dia
источник

AY

Andrei Yemelianov in DocOps-сообщество
что это за диаграммы? можно ли их скормить пандоку?
источник

НН

Нац Нац in DocOps-сообщество
базовый гуглёж показал, что dia можно разве что сконвертить во что-то промежуточное, типа пнг или свг и дальше ими жонглировать http://dia-installer.de/doc/en/re01.html
источник

AY

Andrei Yemelianov in DocOps-сообщество
Нац Нац
базовый гуглёж показал, что dia можно разве что сконвертить во что-то промежуточное, типа пнг или свг и дальше ими жонглировать http://dia-installer.de/doc/en/re01.html
спасибо
сейчас повнимательнее почитаю
источник

MD

Mazin Den in DocOps-сообщество
Может кому будет полезно: Hugo поменял парсер маркдауна

https://gohugo.io/getting-started/configuration-markup/#configure-markup
источник

НН

Нац Нац in DocOps-сообщество
вернуть всё в зад можно в конфиге blackfriday, если ч
источник
2019 November 28

L

Lana in DocOps-сообщество
Привет любимые, выскажите мнение, для задачи документировать архитектурные описания, процессные описания в наборе репозиториев, публиковать в static html, инклуды нужны, сложных таблиц не планируется, поддержка plantuml добавляемая желательна, какой ssg будет лучше? у меня экспертиза вся в сфинксе, я его настрою с закрытыми глазами, но новая команда, они go-шники и маркдаун по порогу вхождения вроде лучше, его итак все разработчики знают. Контрибьютить будут как писатели, так и разработка.
источник

K

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

L

Lana in DocOps-сообщество
Что там щас еще модно кроме сфинкса в мире докопс, hugo, mkdocs, middleman
источник

AY

Andrei Yemelianov in DocOps-сообщество
Lana
Что там щас еще модно кроме сфинкса в мире докопс, hugo, mkdocs, middleman
middleman мне не нравится
источник