Docs-as-Code здорового человека

Посмотрел вакансии на hh по запросу «технический писатель». Чаще всего в требованиях попадались: «понимание подхода Docs-as-Code», «знание Markdown» и «опыт работы с Git». Из чего можно сделать вывод, что Docs-as-Code — это Markdown и Git.

Но докс-эс-код шире. Почему-то команды не используют остальные классные фишки. Например, еще можно:

— Переиспользовать контект И не описывать 20 раз одно и то же. А если изменить исходный текст, то его инстанс изменится во всех документах. Магия.

— Экспортировать документацию в нескольких форматах Одним кликом.

— Проверить текст на ошибки Мы используем Докумишку — наш внутренний инструмент основанный на нейронных сетях. Он проверяет текст перед публикацией и подсвечивает ошибки.

— Согласовать документы И вести список ответственных.

Да, это надо настроить. Но все мы знаем сколько ресурсов экономит автоматизация рутины.

Это того стоит 📄

post image
repost

305

input message

напишите коммент

· 03.07

Бесподобный в своей безполезности пост) я думал, расскажут че нить интересное или практическое. Но нет. «У нас свой инструмент, а у вас маркдаун и гит. Ну тупыыыые»

ответить

03.07

Андрей, привет! Ох, сколько негатива)) Уровень у всех разный, и даже такая информация для кого-то полезна. Если у тебя есть конкретный вопрос, то напиши его под этим постом — попробую разобрать.

ответить

еще контент в этом соообществе

войдите, чтобы увидеть

и подписаться на интересных профи

в приложении больше возможностей

пока в веб-версии есть не всё — мы вовсю работаем над ней

сетка — cоциальная сеть для нетворкинга от hh.ru

пересекайтесь с теми, кто повлияет на ваш профессиональный путь