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

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

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

😡 Не нужны

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

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

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

🥶 Но нужны

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

repost

77

input message

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

· 10.04

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

ответить

12.04

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

ответить

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

Ага, это все Gramax!

**новое в мире отечественного опенсурса:** gramax — это как obsidian или mintlify, но с [лучшими](https://gram.ax/ru)... читать далее
новое в мире отечественного опенсурса: gramax — это как obsidian или mintlify, но с лучшими инженерными практиками | Сетка — новая социальная сеть от hh.ru новое в мире отечественного опенсурса: gramax — это как obsidian или mintlify, но с лучшими инженерными практиками | Сетка — новая социальная сеть от hh.ru
repost

7

input message

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

Ищу фронтендера в Gramax

Окей, давайте попробуем использовать сетку для поиска... читать далее
repost

78

input message

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

Привет, я Катя!

Хочу нетворкать вместе с вами... читать далее
Привет, я Катя! | Сетка — новая социальная сеть от hh.ru
repost

402

input message

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

Отзыв в сетке!

Всегда радуемся с командой, когда находим отзывы на просторах сети. Артем, спасибо, сделали наш день 🫶

Система документации на базе Gramax

Продолжаю развивать систему внутренней и внешней документации на базе open source решения от российских разработчиков... читать далее
repost

37

input message

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

Записали видео о редактировании скриншотов 🧨

Если вы еще не пробовали добавлять рамки и аннотации на иллюстрации в [Gramax](https://gram.ax/ru) — самое время это... читать далее
Записали видео о редактировании скриншотов 🧨 | Сетка — новая социальная сеть от hh.ru
repost

43

input message

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

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

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

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

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

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

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

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