Size: a a a

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

2020 February 18

KC

Kseniya Chudakova in DocOps-сообщество
Nick Volynkin
Вообще, всё сильно зависит от задачи и требований. Какой объём доки, есть ли локализация, есть ли версии, нужно ли автогенерить часть доки из кода, какие выходные форматы нужны.
Отлично было бы запилить общими усилиями сравнительную табличку: это поддерживает это, а в этом проще вот это
источник

NV

Nick Volynkin in DocOps-сообщество
Согласен, есть в планах такое )
источник

NV

Nick Volynkin in DocOps-сообщество
некоторое сравнение есть на сайте https://staticschool.com/
источник

KC

Kseniya Chudakova in DocOps-сообщество
да, посматриваю их
источник

A

Angela in DocOps-сообщество
нет sphinx! непорядок
источник

D

Denis in DocOps-сообщество
Nick Volynkin
Вообще, всё сильно зависит от задачи и требований. Какой объём доки, есть ли локализация, есть ли версии, нужно ли автогенерить часть доки из кода, какие выходные форматы нужны.
А есть готовые решения по генерации доки (md например) из JS-тестов? Cypress, Jest, например. Сходу не нашел, но вижу, что можно написать трансформер для того же Гэтсби.
источник

ID

Ivan Dudkin in DocOps-сообщество
Для тестов есть кастомные репортеры, но это отчёт о прогоне тестов, а не документация
источник

RG

Ramil G in DocOps-сообщество
Коллеги, помнится, был фурор про gostdown - набор инструментов для конвертации маркдаун в документы, оформленные по ГОСТу.  Лично мне это показалось набором костылей, а задействовать виндовый ворд - вообще ставило крест на автоматической сборке через CI. Так вот, обнаружил на мой взгляд самый идеологически правильный инструмент. https://bitbucket.org/Lab50/espd-docbook5/src/master/
источник

RG

Ramil G in DocOps-сообщество
Конвертирует docbook в гостовые pdf. Докбук прекрасного качества получается из asciidoc
источник

D

Denis in DocOps-сообщество
Ivan Dudkin
Для тестов есть кастомные репортеры, но это отчёт о прогоне тестов, а не документация
Странно, учитывая относительную популярность BDD в последние лет 10.
источник
2020 February 19

NK

ID:0 in DocOps-сообщество
Забавная история. Человек искал инструмент для управления зависимостями в Python, невнимательно прочитал доки к Poetry, в итоге написал свой велосипед и статью о нем на Хабре. В комментариях автора убедили, что Poetry решает его задачи. Он прочитал доки внимательно — и правда, решает.

RTFM!
источник

ДС

Дмитрий Саякин in DocOps-сообщество
Ramil G
Конвертирует docbook в гостовые pdf. Докбук прекрасного качества получается из asciidoc
Если не изменяет память, давно занимался, asciidoctor делает docbook с <simplepara/> вместо <para/>, придётся ещё конвертировать.  Может быть, это уже не так или уже легко настраивается, но я писал фильтр на Python, потом адаптировал XSLT.
источник

А

Александр Мокрушин in DocOps-сообщество
Ramil G
Коллеги, помнится, был фурор про gostdown - набор инструментов для конвертации маркдаун в документы, оформленные по ГОСТу.  Лично мне это показалось набором костылей, а задействовать виндовый ворд - вообще ставило крест на автоматической сборке через CI. Так вот, обнаружил на мой взгляд самый идеологически правильный инструмент. https://bitbucket.org/Lab50/espd-docbook5/src/master/
Порой заказчик требует документацию именно в DOCX. В этом случае gostdown - хорошее решение
источник
2020 February 21

NV

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

OK

Oleg Kovalov in DocOps-сообщество
Подкаст "Тимлид позвонит" об управлении знаниями

Поговорили с ребятами из SkyEng про хранение знаний в айти-компаниях, подходах к документированию и всяческих лайфхаках.
Я чуть больше рассказал про систему поиска и практику задавания вопросов, которые мы построили во "Фланте", а ведущие поделились своими историями.

52 минуты о реальной практике: https://www.youtube.com/watch?v=3X1SOZtVxcw
источник

NV

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

NK

ID:0 in DocOps-сообщество
Игорь Цупко, мой коллега из KnowledgeConf, рассказывает про управление знаниями.
источник

NK

ID:0 in DocOps-сообщество
Подкаст "Тимлид позвонит" об управлении знаниями

Поговорили с ребятами из SkyEng про хранение знаний в айти-компаниях, подходах к документированию и всяческих лайфхаках.
Я чуть больше рассказал про систему поиска и практику задавания вопросов, которые мы построили во "Фланте", а ведущие поделились своими историями.

52 минуты о реальной практике: https://www.youtube.com/watch?v=3X1SOZtVxcw
источник

NV

Nick Volynkin in DocOps-сообщество
@olegkovalov может, и тебе есть что рассказать? )
источник

NV

Nick Volynkin in DocOps-сообщество
а то мы ещё принимаем доклады )
источник