Size: a a a

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

2020 May 15

L

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

ВЗ

Владислав Задумов... in DocOps-сообщество
Раньше писали в Конфлюенсе, вариант немного сомнительный, так как предполагается параллельное развитие и поддержка нескольких версий проекта, а версионирование в конфлюенсе только на уровне пространства
источник

ВЗ

Владислав Задумов... in DocOps-сообщество
Вариант плодить набор пространств начальство забраковали сразу
источник

L

Lana in DocOps-сообщество
Без своей инфраструктуры можно поднимать gitlab/github pages, к первому много готовых паков под разные ssg, по сути от вас только нужно gitlab-ci.yml заполнить или взять готовый
источник

ВЗ

Владислав Задумов... in DocOps-сообщество
Смотрели на Help+Manual и Madcap Flare, второй не пропихнуть по бюджету точно =)
источник

А

Александр Мокрушин... in DocOps-сообщество
Владислав Задумов
Смотрели на Help+Manual и Madcap Flare, второй не пропихнуть по бюджету точно =)
а какие требования к выходным документам? Какие форматы?
источник

H

Hartmann in DocOps-сообщество
Владислав Задумов
Смотрели на Help+Manual и Madcap Flare, второй не пропихнуть по бюджету точно =)
Ну отдавать $2.5к за, мягко говоря, нечто, да ещё и работающее только под Windows — сомнительно.
Возьмите Маркдаун и не морочьте голову. Как выше сказали, по поводу SSG, любой подойдёт.
источник

ВЗ

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

А

Александр Мокрушин... in DocOps-сообщество
Владислав Задумов
Предполагается что документация лежит онлайн у нас, с возможностью оперативного контент-менеджмента без пересборки документации (а-ля Конфлюенс, который у нас есть)
не совсем понимаю, как вам поможет Help+Manual
источник

ВЗ

Владислав Задумов... in DocOps-сообщество
Вопрос поднялся из-за версионирования
источник

H

Hartmann in DocOps-сообщество
Владислав Задумов
Вопрос поднялся из-за версионирования
HUGO.
источник

ВЗ

Владислав Задумов... in DocOps-сообщество
Александр Мокрушин
не совсем понимаю, как вам поможет Help+Manual
У них удобный визуальный редактор и возможность подключения к VCS
источник

А

Александр Мокрушин... in DocOps-сообщество
Это плюсы, но я не понял про "без пересборки"
источник

А

Александр Мокрушин... in DocOps-сообщество
В HM придется серьезно подготовиться к началу работы: настроить стили, сильно отредактировать шаблоны сборки в HTML и PDF под свой дизайн и требования
источник

AY

Andrei Yemelianov in DocOps-сообщество
Владислав Задумов
Смотрели на Help+Manual и Madcap Flare, второй не пропихнуть по бюджету точно =)
зачем вам Help and Manual?
источник

AY

Andrei Yemelianov in DocOps-сообщество
он сложный
источник

AY

Andrei Yemelianov in DocOps-сообщество
куча ограничений
источник

ВЗ

Владислав Задумов... in DocOps-сообщество
Andrei Yemelianov
куча ограничений
А можно развернуть?
источник

AY

Andrei Yemelianov in DocOps-сообщество
Владислав Задумов
А можно развернуть?
что и как развернуть?
источник

ВЗ

Владислав Задумов... in DocOps-сообщество
Спасибо, посмотрел, не думаю что нам это подойдёт
источник