Технический писатель 2.0.1.

Опрос про зарплату техписателей показал, что в среднем респонденты зарабатывают чуть меньше среднего по результатам исследования. Давайте подумаем и обсудим, как зарабатывать больше.

Думаю, что доход профессионала пропорционален пользе для бизнеса. Ещё влияют навыки переговоров, зрелость компании, рынок и прочее. Но умение создавать полезный результат и объяснять его полезность — это главное.

Как приносить больше пользы с помощью документации и текста вообще? Как измерить эту пользу? У меня есть доклад как раз об этом: «Технический писатель 2.0.1» Рассказываю про пять нестандартных ролей, их типичные задачи и точки измерения результата:

— DocOps-инженер
— UX-писатель
— Технический евангелист
— Knowledge manager
— Documentation owner

Доклад версионный: я общаюсь с новыми людьми, получаю обратную связь, дорабатываю доклад и рассказываю снова. Пока что было две итерации, так что версия приросла с 2.0 до 2.0.1. Вот запись второго выступления на митапе Write the Docs Moscow #2: Технический писатель 2.0.1.

Очень хочу обратной связи, критики, дополнений и ваших историй успеха в работе с текстом и знанием. Расскажите мне, какие задачи вы решаете, в чём приносите пользу, и как её измеряете. Пишите @nick_volynkin.

А ещё я буду вам очень благодарен, если вы подпишетесь на канал Write the Docs Russia. Сейчас там 13 подписчиков. Будет 100 — у канала появится понятный URL.

Отличная статья "Оля Тележная из Django Girls: зачем нужны женские мастер-классы по программированию".
Я полностью согласна с Олей по всем пунктам.
Пару тезисов из статьи:

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

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


"Есть такое понятие, как diversity – дословно оно переводится на русский как «разнообразие». Что имеется в виду? Хорошо бы было, чтобы в командах были представлены люди с разным менталитетом. Этого можно добиться, нанимая в команду как совсем молодых сотрудников, так и людей старшего возраста. Как женщин, так и мужчин. Представителей как одной этнической группы, так и других. Тем самым обеспечивается очень разношерстный, разнообразный взгляд на продукт, который вы делаете. Пользу смешанных команд для продукта подтверждают исследования. Да, на ранних этапах коммуникация дается такой команде сложнее. Поначалу она проигрывает, грубо говоря, пяти друзьям из одного университета. Зато продукт смешанной команды довольно быстро обгонит по качеству и темпам развития продукт тех пяти друзей. Когда над проектом работают похожие люди, им в голову приходят примерно одни и те же идеи. Когда продукт делают непохожие друг на друга специалисты, они думают об абсолютно разных вещах и тем самым обеспечивают гораздо более высокое качество."

Вместо итогов года в этом канале.

В июле я посмотрела это видео - https://www.youtube.com/watch?v=K6oZuB8_dU8 и поняла, что нормально спала я в апреле в отпуске. И это не смотря на то, что в этот момент я была тоже отпуске между двух работ. Дошла до невролога, получила таблеток и в декабре я чувствую себя пожалуй лучше всего в своей жизни.

Спасибо Илье и близкому человеку, которая дала контакт хорошего невролога и показала собой пример.

Если вы просыпаетесь усталыми больше недели, не можете заснуть или просыпаетесь по ночам - это повод идти к врачу. Решать рабочие задачи, когда у вас есть силы - гораздо проще.

#тлен_и_усталость

На собеседованиях один из стандартных вопросов - что такое тестирование и зачем оно нужно. И это хороший вопрос, позволяющий раскрыть, что кандидат считает правильным и прекрасным. Ну или что он выучил как правильный ответ)

На 9-ом году тестирования я поняла, что действительно не знаю правильного ответа. Все ответы правильны и нет одного единственного, все слишком сильно зависит от контекста - конкретной компании и ее процессов.

Вспоминаю изучение математики - сначала появляются отрицательные числа, потом становится можно делить на ноль и извлекать корни из отрицательных чисел. Вот и тут - есть какая-то опорная точка - обычно из стандартной (заводской) или школы контроля качества, иногда из контекстной. Искать баги, защищать качество, давать информацию. А дальше уже начинаешь думать и осмыслять свой опыт.

#база_тестирования
#подпольный_евангелизм

Я использую феминитивы везде, где могу. И терапевтку чаще, чем авторку)

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

#diversity
#women_in_tech

Документация как комиксы

Когда мне было четыре или пять лет, мама подарила мне книжку комиксов «Откуда берутся дети». Я прочитал, всё понял и в следующие лет 7-10 знал точно больше своих сверстников. Конечно, потом были и другие источники, но тот комикс дал мне начальные знания и избавил от кучи недоразумений.

Теперь мне уже гораздо больше годиков, но за последний месяц я с удовольствием прочитал целых три комикса:

— «Приятного плавания с Kubernetes».
Древнегреческий мореплаватель Ясон теперь работает в IT и руководит отрядом боевых админов. Это сложнее, чем засевать поля драконьими зубами. Богиня Гера знакомит его с «κυβερνήτης», «рулевым». Конечно, Рулевой решает сразу все проблемы Ясона — это же сказка, а в сказке так бывает.

— Как работает DNS.
DNS-запрос путешествует в поисках IP-адреса.

— Как работает HTTPS.
Сертификот и другие звери рассказывают о том, как защитить сообщения в интернете от злонамеренных крабов.

---

Кстати, от того же корня, что и «кубернетес», образованы слова «губернатор» и «гувернёр».

Знаете другие примеры хорошей документации в картинках? Приходите обсудить их в @docsascode.

Интересный материал про то, почему научиться программировать непросто - https://habr.com/ru/company/hexlet/blog/251411/

#учить_и_учиться

Я давно подозреваю, что у менеджера проектов профессиональное заболевание — ОКР.

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

Правда, благодаря работе состояние может ухудшиться, потому что раз за что-то платят, то надо Расти и Развиваться, изучать новые техники контроля за окружающим миром, делиться ярким опытом порабощения свободного времени и продвигаться в микроменеджменте.

В посте https://xn--r1a.website/uri_gde_knopka/1049 про меня вот эти пункты:

не опаздываешь никуда, потому что начинаешь сборы за неделю, а приезжаешь в аэропорт за 4 часа.

вещи кладешь на место, потому что иначе ВСЕ ВРЕМЯ ОБ ЭТОМ ДУМАЕШЬ.

работаешь оч эффективно, пч ТАБЛИЧКИ СПИСКИ И СПИСКИ СПИСКОВ пишешь каждый сука день и нельзя лечь спать, не ответив на все письма за сегодня. ладно, вообще на все.

И да, с одной стороны — это всё очень удобно. И в работе полезно. Как писала Брене, психологическая защита часто становится профессией: http://authenticityfirst.ru/brene-braun-kak-psihologicheskaya-zashhita-stanovitsya-professiej/.

А с другой — очень много сил уходит на какое-то балансирование. Не слишком ли я расслабилась, не ответив на ОДНО письмо перед сном? Не слишком ли я впряглась, сделав всё ещё быстрее, чем ожидала от себя? И так далее.

🤷

Мне кажется, что это и к нам тоже относится.

Я так точно монетизирую то, что успокаиваюсь когда разбираюсь в чем-то, понимаю как на самом деле все работает и как ещё все может пойти не так.

#тлен_и_усталость

Консультирую про тестирование

Я не умею писать продающие тексты, поэтому будет обычный и про меня.

Я в тестировании 8 лет, много видела, много осмысляла и хочу делиться опытом. Последние пару лет я веду в телеграме канал . А теперь предлагаю еще и личные консультации по вопросам тестирования.

Мою любимые области - зачем все это и как оно все работает? И что мы можем со всем этим сделать, чтобы всем стало хорошо:)

Мне интересно слушать людей с их запросом и думать вместе над тем, что могло бы быть хорошим решением в их случае. Я не знаю готовых ответов и у меня нет серебряной пули, но вместе мы можем найти что-то подходящее.

Я не готова консультировать по деталям автоматизации и нефункционального тестирования, но возможно смогу посоветовать коллег. В остальном я могу подобрать информацию под запрос, обработать ее и мы ее обсудим.

Я люблю разговаривать про тестирование для начинающих. Какое есть сейчас тестирование? Куда смотреть и с чего начинать? Чему учиться в первую очередь.

А еще одна из интересных для меня тем сейчас - это тестирование для нетестировщиков. Чем теория и практика тестирования сможет помочь разработчику, системному аналитику или менеджеру.

Формат

На короткие вопросы а-ля "Что почитать по тестированию?" отвечаю бесплатно и в личке.

Более объемные запросы на то, что происходит в современном тестировании и что делать с набором конкретных проблем - предлагаю встречи в Москве в кофейнях. Длится это обычно 1,5 -2 часа и стоит тысячу рублей.

Писать можно мне в личку - @red_foks

#подпольный_евангелизм
#консультации_по_тестированию

Картиночка в тему от Iban Barrenetxea (http://www.ibanbarrenetxea.com)

По фидбеку добавила в пост описание формата и условий.

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

Я только сейчас доосмысливаю летний тренинг Дарьи Иванюшиной по Dragon Dreaming. Что для меня и моих проектов означают мечтание, планирование, действие и празднование.

#учить_и_учиться

Про два вида знания в терапии.

Нередко на сессии клиент говорит: "Я знаю, что *далее следует некоторое знание*, но... (все равно не помогает/у меня не получается/жить от этого не легче)".

Знание я условно разделяю на два типа: головой и нутром. Головой - это больше про информированность. Вот, скажем, много говорят о том, что чувствовать и выражать злость - нормально. Или о том, что у человека должны быть здоровые личные границы (читай - способность отличить свое от чужого, отвечать за первое и оставить другим людям второе). Или более узкое: что кабинет терапевта - безопасная территория, где можно свободно быть. Я знаю, потому что услышал/прочитал. Потому что об этом говорят и пишут. Словом, я информирован о существовании такого феномена.

Но если у человека не было опыта, который бы это знание, во-первых, подтвердил (= так бывает не где-то там, а вот тут, совсем рядом, в моей жизни), а во-вторых, интегрировал бы его в жизнь (= теперь я не только информирован, но и прожил это, получил чувственный опыт), то сам факт знания, действительно, может казаться бессмысленным. Ну, знаю я. И что?

Одна из иллюзий про терапию - идея о том, что понять/осознать/увидеть = изменить.

Иногда этого правда достаточно для того, чтобы инициировать перемены. Где есть знание "из головы", там возможность отслеживать его проявление в жизни, наблюдать, анализировать, учиться другому поведению. (Так что, пожалуй, не вполне справедливо я пишу "иллюзия"). Если, скажем, человеку свойственно катастрофическое мышление (постоянное "Ааа, все пропало, мы все умрем в муках - и я первый!"), знать, что это называется катастрофическим мышлением и является когнитивным искажением, а вовсе не объективной реальностью, может помочь. Вооружившись этим знанием, можно отслеживать, при каких условиях запускается эта реакция. Что ее разжигает еще больше, а что наоборот, гасит или помогает успокоиться. Можно поработать с конкретными техниками и научиться эту реакцию изолировать и проверять на bulshit еще до того, как она затопит по самую маковку.

И то же самое "Ааа, мы все умрем" может ну совсем не поддаваться логическому знанию. Ну да, головой понятно, что на самом деле не все так плохо. И не умрем. И мук не будет. Но это головой. А внутри человек каждый раз проваливается в черную яму и умирает на дне. Потому что очень хорошо знает, как ненадежен мир и люди. Не обязательно головой знает, кстати. Опытом. Например, еще в младенчестве мамы часто не было рядом, или кормила она ребенка по расписанию, а он испытывал голод и не получал грудь. Воспоминаний об этом ноль. Но нутро очень хорошо помнит, как это. И постоянно генерит недоверие в промышленных масштабах. "Ничего не будет хорошо, - говорит нутро. - Мы с тобой это уже проходили".

И да, терапевт может выдвинуть гипотезу, что сегодняшнее "Ааа!" связано с далеким детством. И человек может даже пораспрашивать маму и подтвердить эту гипотезу. Но от этого все еще не легче. Окей, теперь я более осведомленный, но все такой же несчастный. Зачем тогда знать?

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

Так что если вы все знаете, но от этого не легче, это еще не конец. Возможно, на самом деле вы еще не знаете.

#записная_книжка

Основы работы с Git в картинках - https://habr.com/ru/post/437000/

С интересом смотрю на тренд середины прошлого года-начала этого - тимлидство, тимлиды и их проблемы.

Teamlead Conf, сообщество тимлидов devleads - с подкастом, peer lab и группой в фейсбуке, отдельная секций Teamlead на Codefest.

Интересно, к чему это все приведет. Насколько выйдут из тени социальные и культурные вопросы?

#менеджерское

Продолжаю думать про работу и вовлеченность. Мне кажется, что наши отношения с работой все больше становятся похожи на романтические отношения. И если в семейной сфере много от "мифа о романтической любви", то в рабочей царит "миф об идеальной компании". Которая дает и все признание, и поддержку, и реализацию новейших технологий, и стабильную зарплату с хорошими условиями, и коллег-друзей с сообществом, и что-нибудь еще.

С одной стороны это дискурс про все, то что работа должна быть призванием и увлечением. С другой стороны этот миф поддерживают компании-мечты - тот же Гугл, Фейсбук, Яндекс. Максимальная вовлеченность, компания-семья, даже если это большая корпорация и чтобы ничего не отвлекало от работы. И как и с идеальными романтическими отношениями от этого сложно отказываться, даже если тебе это не подходит. Потому, что миф же, к которому все должны стремиться. И рассказывают про изнанку это мира все больше в частной беседе по барам.

Сейчас мне все больше кажется более устойчивой конструкция, когда реализация в рабочей сфере не держится на одной конкретной компании. Когда есть поддержка коллег и сообщества, какие-то профессиональные проекты кроме работы и конечно же вся остальная жизнь. И ты можешь сформулировать для себя, что ты хочешь от отношений с этой компанией.

И я к этому сейчас иду.

#тлен_и_усталость

Разбирала презентации с последней SQA-Days и среди советов про автотестирование опять нашла "отдать поддержку ручным тестировщикам". И снова думаю про это.

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

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

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

#подпольный_евангелизм