М
ну в конфлюенсе действительно приятный интерфейс
особенно если еще пара плагинов
особенно если еще пара плагинов
Size: a a a
2021 November 19
ЕЕ
Плагины платные? Просто от руководства пришло, что тратиться на confluence не планируют.
SR
В Confluence разметка хуже. Там плюс в том, что это веб-платформа с распределяемой нагрузкой, плюс терпимый встроенный редактор.
M
Сама конфа платная, плагины для нормального выпуска документации в разных форматах и для переводов - очень платные. Всё же это прежде всего решение для ведения базы знаний.
SR
Если что-то серьёзное, всё платное. Причём с особенностями. Скажем, есть возможность добавить версионирование. Плагином. Круто? Конечно! Внедряем. Внедрили, и в какой-то момент появились проблемы с переименованием страниц.
То есть не панацея.
То есть не панацея.
М
да, платные :(
M
О, и конфликтовать могут. И поддержка новых версий внезапно может отвалиться, потому что вендор плагина тупо забил на его развитие
ET
А авторы - это кто? Менеджеры, писатели, разработчики, QA? ЦА docs-as-code тоже имеет значение
ЕЕ
Разработчики. Вот том то и дело.
KC
Случайно увидела курс, хватайте https://stepik.org/course/684/promo
ДЧ
Проходила этот курс, советую! Раскрывает подход к английскому языку в документации с точки зрения Microsoft Style Guide.
ЕЕ
Тут скорее первая половина будет полезна. Вторая больше про правила английского языка.
SR
"All communication is carried out only in English. I will not respond to any comments in Russian:)"
Nice one.
Спасибо, что поделились!
Nice one.
Спасибо, что поделились!
S
Благодарю за рекомендацию
IM
полностью поддерживаю, документация это часть продукта и неотъемлемая. и не просто даже приложение к продукту. особенно эксплуатационная документация. в госах нормально писать документацию на мифические продукты выдавая ее за реально существующие в тех объемах, характеристиках и прочем что им приписывается в такой документации
G
Обожаю связку Asciidoc + Antora, в субботу следующую в соседнем канале провожу встречу, плюс скоро опубликую статью на Хабре про это всё дело.
G
Встречу в канале mob writing, 27.11 в 13:00. Статьей обязательно поделюсь, как будет готова.
ЕЕ
Спасибо. С удовольствием почитаю.
G
Antora + Asciidoc полностью бесплатные, много удобных фишек, порог входа доступный. От старта до готового сайта с версионированием можно добраться за неделю или даже раньше. Другое дело - конвертация. Перевести текущую документацию на это дело требует времени. Если переносить не нужно, а требуется сразу новую писать в новом формате, то гораздо проще.
G
И главное - поддержка и сообщество. Можно напрямую с разработчиками общаться и спрашивать всякие вещи. Dan Allen (mohavelinux) вообще прекрасен.