Телеграмм чат группы docsascode страница 350

Можно ли превратить создание документации в процесс.

На конференции #CodeFestX мы проводили квартирник про DocOps и документацию в целом. Рассказывали, как внедрять хорошие практики и процессы документирования. Я делился опытом внедрения DocOps и работы над документацией в Plesk, а Семён — опытом своей компании documentat.io, которая аутсорсит разработку документации.

Смотрите видео, шлите обратную связь (@factorized и @nick_volynkin), пишите автотесты на доки. :)

https://www.youtube.com/watch?v=fMcyiVju9Tg

YouTube

#Квартирники, С. Факторович, Можно ли превратить создание документации в процесс

Семён Факторович documentat.io Можно ли превратить создание и поддержку документации в процесс, или что такое DocOps Процессы разработки, тестирования и депл...

источник

08:11пожаловаться #9

Timofey Zakrevskiy in DocOps-сообщество

Нац Нац

Доклад оч хороший, если эт он

Содержание - отличное, устная часть так себе

источник

14:45пожаловаться #10

Nikolaj Potashnikov in DocOps-сообщество

Jaroslaw Martinow

Опробовали уже?

Смотрел, мне не хватает только таблиц

источник

17:04пожаловаться #11

2019 June 30

Jaroslaw Martinow in DocOps-сообщество

Nikolaj Potashnikov

Смотрел, мне не хватает только таблиц

А какие требования у вас к таблицам? В чём сейчас их делаете?

источник

11:17пожаловаться #12

Nikolaj Potashnikov in DocOps-сообщество

Jaroslaw Martinow

А какие требования у вас к таблицам? В чём сейчас их делаете?

В основном, в Asciidoctor'е. Там тоже хотелось бы чуть лучше, но уже почти. По крайней мере все хоть кривенько, но решить можно. Md тоже используется, как бы то ни было, распроранен он гораздо больше и для многих удобнее и проще. В общем, счастье возможно, но его пока нет

источник

17:27пожаловаться #13

Nikolaj Potashnikov in DocOps-сообщество

Требования обычные — заголовки, повторящиеся строки, соотношение ширин, объединения ячеек, использование расширенного форматирования внутри ячеек, подтаблицы.

источник

17:29пожаловаться #14

2019 July 01

Fox Mulder in DocOps-сообщество

Скажите. Есть возможность подружить foliant + pandoc с confluence?

источник

14:40пожаловаться #15

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

Мы пока вставляем markdown-файлы в конфлюенс плагином по ссылке в репозиторий: https://marketplace.atlassian.com/apps/1211445/markdown-for-confluence

Понемногу думаем в сторону импорт-экспорта через API конфлюенса

Atlassian Marketplace

Markdown for Confluence

Create and render Markdown content — right within Confluence