Спасибо, это уже гораздо более четкие вводные! и теперь еще раз,

Question

Технические писатели

Семён Факторович

Спасибо, это уже гораздо более четкие вводные! и теперь еще раз,

в чем был ваш изначальный вопрос?

0

15.10.2023

6 ответов

14 просмотров

Семён Факторович Автор вопроса

Михаил
О роли тех писателя в таких командах, когда спроек...

Слушайте, ну мне постановка вопроса кажется в целом неправильной. Кесарю кесарево, слесарю слесарево: есть документация, которую пишут аналитики, есть документация, которую пишут техписатели. В разных компаниях граница между этими видами документации (и между этими двумя профессиямии) очень разная. У вас есть задача прочертить эту границу? Чертите исходя из ваших бизнес-реалий, чужой опыт вам вряд ли поможет — именно из-за большой разницы контекста. А еще можно убрать из картины разделение на роли/профессии и просто искать тех людей, которые будут качественно писать четко определенные виды документов, нужные вам в вашей ситуации. Назовите этих людей хоть архитекторами. В моем опыте: - системные аналитики очень неохотно и с невысоким качеством делают пользовательскую документацию - работа с требованиями — не профильная деятельность для техписателей - документация, адресованная разработчикам, всегда (всегда!) становится лучше, если к ней прикладывают руку техписатели - на длинных дистанциях вопросы актуализации, структурированного хранения и удобных выходных форматов важнее, чем собственно написание первой версии документов. Эти области — вотчина техписателей, не аналитиков

0

15.10.2023

Михаил

Семён Факторович
Слушайте, ну мне постановка вопроса кажется в цело...

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

0

15.10.2023

Семён Факторович Автор вопроса

Михаил
О роли тех писателя в таких командах, когда спроек...

> суть [вашего вердикта] том, что такой компаний штатный техпис не нужен. Нет, это вы услышали в моих словах то, что сами хотели услышать:) Я говорил о ситуациях, когда характер коммуникации в команде разработки таков, что попытка перевести обмен информацией в твердые форматы (т.е. всё задокументировать) получается слишком дорогой. Чаще всего это связано с тем, что продукт меняется слишком быстро, и постоянно обновлять, например, описание архитектуры — ресурсозатратная активность. В таких случаях мы говорим команде: «вам дешевле будет не писать документацию — продолжайте общаться устно или в мессенджерах»

0

15.10.2023

Arina Ballerina

Семён Факторович
Слушайте, ну мне постановка вопроса кажется в цело...

Кесарю кесарево, слесарю слесарево 👍 Кстати, с днём отца (основателя:) тебя, Семён! Спасибо тебе за популяризацию профессии!

0

15.10.2023

Lidia Tulyaganova

Михаил
Насчёт степени важности написания первой версии до...

Аналитик расписывает бизнес требования для разработчиков. Сколько "ручек" и какие они нужны - эта информация не поможет конечным пользователям, поэтому техписатель создает отдельный продукт. Если аналитики могут писать документация для пользователей и вести внутреннюю базу знаний, это не значит, что компании не нужен техписатель. Это значит, что функцию техписателя выполеяет аналитик. В этом случае неважно, кто ее выполняет.

0

15.10.2023

Михаил · Accepted Answer

О роли тех писателя в таких командах, когда спроектированные аналитиками сервисы, технологии и интерфейсы взаимодействия требуют всего лишь наблюдения и возможной корректировки. Учитывая тот факт, что аналитики могут справиться с написанием внешней документации без привлечения в штаб/аутсорс тех писов. P.S. у вас в курсе есть несколько фраз, когда ваша компания выносит похожий моему предположению вердикт, после аутсорса компании-клиента. Его суть том, что такой компаний штатный техпис не нужен. В последнем предположении могу ошибаться)

Похожие чаты

Спасибо, это уже гораздо более четкие вводные! и теперь еще раз,

6 ответов

Похожие вопросы