О концепте поговорили, сегодня поговорим об инструментах 🤥 ⏺Git — для совместной работы над текстами. ⏺Платформа Docs Ozon — для генерации текста в сайт, доступный пользователям. ⏺Figma — для текстов интерфейсов, оформления скриншотов и мозгового штурма. ⏺Jit, Confluence — для управления проектами и знаниями внутри компании.

Техписатель работает над задачей в несколько этапов: сначала он получает заявку в Jit на новую статью или доработки старой.

Потом уточняет у заказчика аудиторию и цель текста. Если надо — проводит интервью или даже несколько, чтобы разобраться в теме статьи.

После этого — пишет черновик в markdown и оформляет merge request, чтобы коллеги могли его вычитать.

Дальше техписатель вносит правки и отдаёт черновик на проверку заказчику.

Когда правки закончатся — ещё раз перепроверяет текст и выкладывает его на платформу через три контура: тест, стейдж и только потом прод.

На каждом этапе заказчик и хотя бы один другой техписатель должны подтвердить изменения, чтобы ничего лишнего или неправильного не оказалось в проде

Такой подход к работе с текстом называется docs-as-code 🤵

Важная часть работы над текстом — стайлгайд. Он помогает большим командам придерживаться одного стиля и не спорить каждый раз про оформление списков.

Наш гайд публичный — выложили его специально для этого поста — пользуйтесь, вдохновляйтесь, делитесь обратной связью 😳