nyygnet 3 апр в 07:15

AI в работе технического писателя

Средний

4 мин

1.5K

Sphinx*Искусственный интеллектПодготовка технической документации*Python*

Из песочницы

Комментарии 6

rampler 3 апр в 08:04

Странно. Вроде как налить воды и нагенерировать текст на пару страниц - тут у ботов нет конкурентов. Это давно известно.

Мы так уже второй год используем , чтобы закрыть KPI по написанию рабочих инструкций , которыми все равно никто не пользуется .

nyygnet 3 апр в 09:29

Насчет воды вы правы. Жаль, что у вас так настроен процесс документирования. Мне в работе как раз не нужно воды. Нужно кратко, по делу и с пользой для читателя

mcsimm 3 апр в 09:15

По поводу кейса №5 - есть же в Linux хорошая утилита "tree", которая прекрасно с этим справляется. Куча опций вывода (XML, JSON, HTML), сортировка и т.д.

nyygnet 3 апр в 09:25

Спасибо! Буду знать. Я на винде работаю и живу

AidaUK1 3 апр в 16:02

А если взять в сравнение документацию на md, почему бы её не использовать, нежели чем Sphinx ? Какие она имеет преимущества в написании документации тут ?

nyygnet 3 апр в 16:03

Markdown хорош для простой документации, а Sphinx — для крупных проектов. У Sphinx больше интерфейсных инструментов, кросс-ссылки, расширения. При этом сложнее синтаксис и выше порог входа. Если нужно быстрое описание — хватит Markdown, если строить техдок как систему — лучше Sphinx

Зарегистрируйтесь на Хабре, чтобы оставить комментарий

AI в работе технического писателя

Комментарии 6

Публикации

Истории

zproxy.org