Привет, и, как вы знаете, я технический писатель. Профессия техписа сама по себе достаточно скучна, требует определенного занудства, терпения и усидчивости.
Но достаточно мало кто понимает, кто такие технические писатели, и чем они занимаются. Очень часто нас путают с просто писателями, но это не так.
Кто мы – такой информации уже много в сети, мои коллеги весьма полно ответили на данный вопрос, но вот что мы делаем, уткнувшись в монитор, и как проводим рабочий день, вот этих сведений мало, и я хочу хоть немного исправить этот пробел.
Ниже один обычный день совсем обычного техписа в Москве.
?Ну что, поехали!
7.24
Я проснулся, потянулся. Жена уже собирается в ванной. Посмотрел за окно – темновато и, наверное, зябко, поежился, но делать нечего, надо вставать и собираться.
Жена как раз пошла поднимать ребенка.
8.10
Вышел из дома и иду к остановке трамвая. Сегодня очередь жены отвозить и привозить ребенка из детского сада, поэтому могу выйти из дома чуть-чуть позже.
Дохожу за 5 минут до остановки. Холодный ветер делает пребывание на улице некомфортным, хочу или домой, или на работу.
Наконец, подъехал транспорт, и я еду к метро.
8.35
В метро. Тут сухо, тепло, много народу и кашля.
Пока еду, читаю книгу.
9.10
Манная каша, пудинг и черный чай с молоком. Нямка.
9.30
Я у своего рабочего места.
Рядом со мной живая пальма, а еще беспроводные наушники Sony, два ноутбука (нет, мака, увы, нет), один 24” монитор, мышка и клавиатура. Вот такой стандартный набор.
Первым делом проверяю рабочую почту, потом планирую фронт работ. Вчера ночью пришли новые идеи, записываю их в блокнот, идеи здравые и требуют воплощения на бумаге.
Пишу в markdown с помощью Visual Studio Code, далее подкладываю файлы в hugo, тем самым генерируя статичный сайтик с документацией, и всё это заливаю сверху гитом. В планах еще автоматизировать отправку md-файлов напрямую в Confluence.
Сегодняшний день будет полностью посвящен архитектуре нашего продукта. Описание архитектуры требует отличного знания как OpenStack, так и наших модулей, сервисов и т.п.
В планах разобрать по косточкам neutron и, если успею, – glance. Приходится аккумулировать просто тонну информации и прогонять её через фильтр нашего продукта.
10.47. Сделал высокоуровневую диаграмму по службам neutron и дал им краткое описание. Далее планирую углубиться в эту тему.
Пока сделать перерыв и пойти выпить кофе. С кофе главное правило – не увлекаться. Наливаю кофе и иду к обратно.
12.10
Пора идти на обед. Это мой первый обед, стараюсь делить прием пищи на два раза, так полезнее.
Моя первая порция: булочка и куриная лапша. Очень вкусно.
12.25. Я снова за ноутом. После обеда, даже такого легкого, появилось желание поспать. Нихт, арбайтен, архитектура сама себя не опишет.
Хочу помощи зала. Пишу, рисую, разбираю рулбуки.
14.30. Второй великий обеденный поход.
Вот такие макарошки с куском индейки. По правде говоря, было очень средне, обычно готовят намного вкуснее.
Десять минут на обед, надо подготовиться к стендапу. К стендапу надо отчитаться о проделанной работе, и что планирую сделать на сегодня.
15.20
Стендап. Командой обсуждаем наработки. На всё про всё минут 15, продуктивно и не затратно.
Планов у команды много, идей еще больше. Это хорошо, под такие задумки мне стыдно выдавать слабый материал.
17.40
Решил сделать перерыв и сходить за мороженым. Да и глаза отдохнут. Хорошо далеко идти не надо, мороженка продаётся в столовой, а так было бы лень.
Увы, план не выполнил, на glance нет уже сил, слишком объемный материал выходит по neutron, придется даже завтра с ним разбираться.
Ставлю пометку, что надо обязательно выделить минут 30 и помучать hugo, мне не всё в нём понятно. Когда дойдут руки до confluence API, я даже не представляю, времени нет даже на выходных.
19.55
Пора собираться домой.
Пробегаю глазами текст документа, оставляю в блокноте заметки, что надо сделать завтра, и иду одеваться.
20.15
Выхожу из офиса. Пошел снег с ветром в придачу. Странное состояние. Сверху, в районе головы холодно, а под ногами черная и чавкающая жижа. Но это ерунда: дома ждет жена, ребенок и салатик.
В метро хочу снова перечитать книгу “Пиши, сокращай”, но тут выяснилось, что в телефоне её нет, почему – загадка. Ну и ладно, глаза будут целее.
Вот такой вот он день, обычного русского технического писателя: ни тебе борьбы с суперзлодеями, ни одной спасённой красавицы. На самом деле не скучно, я люблю писать, и писать любит меня.
Но только не ГОСТ!
Всем авторам замечательных рисунков – спасибо Вам большое! Ваши работы найдены в сети Интернет.