В интернете полным-полно мемов о видении себя в профессии. Все потешаются над руководителями, над кадрами или штатом продавцов. А чем я, технический писатель в летах и орденах, хуже. Давайте вместе с вами посмотрим на разные видения, улыбнемся и может даже узнаем себя или знакомые ситуации.
Поехали!
Как я вижу со стороны руководства.
Очень часто в мировоззрении руководства любые действия делаются по щелчку пальца, в независимости от квалификации. Сверстать стиль для pdf на xsl, не зная оный? А что там делать, за день управишься. Написать метр документации к понедельнику, когда сказали вечером в пятницу? Лоботряс и лодырь, да у меня племянник это сделает бесплатно, а мы тебе еще и деньги платим.
Я думаю, начальство видит нас, технических писателей, вот так:
Как я вижу со стороны пользователей
Пользователь избалован количеством источников документации, а когда информации много, то восприимчивость притупляется, да и извечный принцип - я лучше знаю, существенно снижает потребность в документации. Иногда я думаю, зачем мы вообще ее [документацию] пишем, для галочки? А ведь, помимо факта наличия самой документации, мы должны заботиться и о контенте, как авторскую подачу материала воспримет читатель сего манускрипта, будет ли она ему удобна для поиска ответов, или Кутузов на второй глаз ослепнет.
Главная цель работы техписа - написать понятный и подробный свод знаний о продукте для конечного пользователя, и, как мне кажется, для пользователя это выглядит вот так:
Как я вижу со стороны коллег по работе
Для беспечного аналитика нет ничего более жуткого, чем постоянные звонки технического писателя в 12 часов ночи с вопросом, когда же наконец-то будет информация по продукту. Еще разработчики спят плохо, когда техписы начинают проводить больше рабочего времени в обнику с ними. И ведь что-то хотят, требуют, заставляют - то примеры кода по новой фиче набросать, то комментарии к коду писать. Да тут еще тестеры льют горькие слезы от тикетов техписов, они ж, паразиты, еще и тестировать успевают, что описывают (ну как вам не стыдно, а).
А уж как нас не любят руководители, стыдно написать. И вот бегает такой бедный техпис по офису, что-то требует, что-то хочет, всех достает. Все ему нужны, все ему потребны, от отчаяния технический писатель даже к тЁте Зине, уборщице, пристает, вдруг она слышала, когда места программистов убирала. Но коллеги видят техписа примерно так:
Как я вижу себя со стороны
Как же я вижу себя сам? Вот я хороший, правда. Кто, как не я, знает о продукте все, кто, как не я, может написать и про новую менюшечку в веб-морде, и слабать на swagger описание API. А еще я могу и рекламный буклет подготовить к выставке, и помню все изменения в продукте.
Вот такой я самый незаменимый работник в офисе, ну, кроме тЁти Зины, не все сотрудники овладели скиллом хэдшота. Как я вижу сам себя? Конечно в костюме супермена, в обнимку с .. и большой зарплатой!
Вру, на самом деле вот так: