Технические писатели (не)нужны

Увидела классный анонс в канале технического писателя (https://setka.ru/communities/018ea088-1459-408f-b6c6-120946f996f2) и вспомнила холиварный поинт: «Технические писатели не нужны. Их наличие в компании означает то, что сотрудники на других позициях не справляются со своими обязанностями».

Да, не нужны, но нужны. Сейчас разверну.

😡 Не нужны

Любая документация — результат работы над проектом или продуктом. Перед стартом всегда готовится проектная документация: проблема, варианты решения этой проблемы, техническое задание. По ней уже формируются задачи в разработку.

В идеальной картине мира задача в разработку = пользовательский сценарий. И из этого пользовательского сценария можно формировать итоговую документацию и инструкции.

Значит перед релизом аналитик может взять всю доку и просто немного ее подкорректировать.

🥶 Но нужны

Только аналитик не будет этого делать. А кто будет?

repost

73

input message

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

· 10.04

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

ответить

12.04

Это крутой уровень организации и ответственности! Респект🙏

ответить

еще контент автора

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

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

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

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

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

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