Обещал своё мнение, вот, опубликовал.

​​Польза и ценность технического писателя

«Я теперь хочу нанять себе техписателя, потому что знаю, что есть нормальные техписатели» — сказал мне на Highload Siberia Александр Титов, управляющий партнёр компании Экспресс 42.

Надеюсь, Александр ещё расскажет, какими он видит нормальных техписателей. Я вижу их так: «разговаривают на языке инженеров и бизнеса, понимают их глобальные задачи и хотят решать эти задачи».

Хочу больше писать о том, как технический писатель может приносить пользу в масштабе компании. Хочу сокращать разрыв между писателями, инженерами и бизнесом. Пожалуйста, поделитесь своими мыслями о пользе техписателя в чате @docsascode или напишите мне (@Nick_Volynkin). Этим вы очень поможете мне и моим коллегам. А мы постараемся быть полезными всей IT-отрасли.

На фото Александр зашёл к нам на стенд на Highload Siberia.

«разрабы должны писать для разрабов» — часто разработчики не очень хорошо пишут на естественном языке.

«за этим не совсем тп должен следить» — а почему бы и нет? Техписатель же умеет понять сложное и изложить просто и понятно. Значит, может и для разработчиков писать.

К слову, 1500 коммитов это не так уж много, вот вам 767 000 коммитов: https://github.com/torvalds/linux

Кажется, тут два варианта есть.

Либо техписатель реально может провести такую аналитику. Тогда он проводит её максимум один раз, а потом устраивается в другую компанию на должность могучего писателя-аналитика и на удвоенную зарплату.

Либо техписатель не может. Тогда можно так и оставить, а можно учиться проводить аналитику.

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

Отсюда два вопроса:

— куда техписателю копать, что делать, чтобы создавать дополнительную ценность для компании
— какими аргументами обосновать эту ценность для руководства

Вот у Ильяхова есть статья про переговоры о зарплате. Там есть похожие идеи: https://clients.glvrd.ru/salary.html

О, вот этот аргумент мне симпатичен. Быстрее доставка — быстрее можно продать. Или быстрее исправить ошибку.

Ser про количество коммитов ещё хотел добавить. Не в количестве сложность разработки. Новый разработчик, как я понимаю, смотрит не на историю коммитов, а на текущий код и (если есть) документацию к нему.

У Ильяхова есть ещё пара заметок в этой области: http://maximilyahov.ru/blog/all/market-pricing/ и https://journal.tinkoff.ru/thedeal/

Ты зарабатываешь ровно столько, сколько стоишь... Я знаю по себе. Я арабатываю n денег, знаю человека, который за эту же работу в этой же компании зарабатывает n*2)))) так что тут зависит от того насколько ты ценишь себя как спеца видимо

Не совсем верно. Ты зарабатываешь ровно столько, за сколько себя продал.

Ну или так. Смысел  - все зависит от тебя

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

Проиллюстрирую на своём недавнем примере ответы на оба вопроса. На текущей работе совмещаю обязанности аналитика и техписа. В роли аналитика я в своё время выяснял у начальства информацию по ценообразованию товаров с точки зрения бизнеса, чтобы потом было проще писать ТЗ, ибо аналитики у нас знают больше техническую сторону. Эта информация была зафиксирована на диктофон, и после был сделан черновой вариант расшифровки. Время показало, что эта информация оказалась нужна практически всем аналитикам и помогала в решении некоторых обращений в техподдержку. Поэтому логичным выводом стала идея о фиксировании этой информации в базе знаний ещё и с учётом технических знаний аналитиков. Но я не могу просто взять и написать это - без согласования этой задачи я не получу за неё деньги, а время рабочее потрачу. Поэтому занимаюсь формированием чего-то типа коммерческого предложения для отдела ценообразования. Я описываю:
-- что я хочу написать как техпис (комбинированную информацию по системе ценообразования)
-- почему я хочу это написать (ожидаемые выгоды и примеры случаев, подтверждающие мою теорию выгоды)
-- план действий с ориентировочными сроками реализации.
И когда бизнес видит обращение от техписа на языке бизнеса, то сразу всё согласуется и находятся деньги, либо хотя бы задача ставится в очередь к выполнению в обозримом будущем, если бюджет на текущий месяц распланирован. В моей ситуации я по факту временно увеличил размер бонуса у ЗП, потому что такая деятельность стоит дороже моих рядовых аналитических задач.
По сути всё то же самое, что и в статьях у Ильяхова: нашёл проблему, согласовал бюджет, выполнил ценную работу и получил деньги. Если так делать постоянно, то вот вам и увеличение ЗП при системе "оклад + бонусы".

Илья, ты как второе сообщение за 10 секунд написал? ))

Я просто разбил заранее заготовленное на два =)

Телеграмм неудобен для ввода текста, постоянно путаюсь с горячими клавишами при отправке

Тут можно редактировать, если что )