#колонкаредактора
Всем привет! "Где учиться на техписателя?" — самый частый вопрос от новичков. Это важный вопрос, но мы предлагаем начать с другого: как учиться на техписателя?

Самообразование, курсы, менторы — три уровня образования

Почему мы рекомендуем выстроить обучение именно так? Рассказываем.

1️⃣ Самообразование

Новички всегда в поисках курсов. Кажется, что появится школа, которая всему научит. Но техническая документация — очень широкое понятие. Ни одни курсы не принесут вам пользы, если не знать, что именно вы хотите изучить.

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

Всем новичкам мы предлагаем:
*️⃣Посмотреть курс на ютуб от Документата,
*️⃣Почитать редполитики, например, редполитику Госуслуг,
*️⃣Почитать книгу Кагарлицкого (ссылку дали как пример, что-то цена там неконкурентная),
*️⃣Подписаться на нас и почитать посты с начала 😊

2️⃣ Курсы

Курсы, которые испытаны нами лично, посоветовать не получится, потому что они не вынесли испытание временем, хотя были очень хороши.

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

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

3️⃣ Менторы

Кто такие менторы? Это опытные технические писатели, которые за деньги (от 2 000 рублей за час) помогут вам решить конкретные задачи в обучении. Например, они могут выстроить индивидуальный план обучения, исходя их ваших знаний, либо поделиться знаниями в конкретной области.

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

И тут мы снова возвращаемся к пункту 1 😉
Самообразование — основа всего обучения.

🔆 Если вы уже прошли какой-то хороший курс или нашли хорошую публикацию, поделитесь, пожалуйста, ссылкой на них в комментариях.

Также вы можете оставить ссылку на свой канал или курс, если они посвящены технической документации.

Давайте соберем для новичков полезную информацию.

#писалитирекомендует

Всем привет!
И в том числе привет всем новеньким подписчикам❤️

Мы решили помочь вам выжать максимум из нашего канала. Будем публиковать дайджесты с ранними постами, которые могут быть интересны в свете обсуждений в сообществе, например, в жёлтом чате.

Итак, популярная тема на этой неделе — грейды техписателей.

У нас по этой теме:

1️⃣ Грейды технических писателей: примерная лестница для новичков и бесплатная основа для вашего ранжирования. Забирайте и подстраивайте под себя)

2️⃣ Чем сеньор отличается от джуна? Размышления у парадного подъезда)

3️⃣ Что делать джуну, если лид ушёл в отпуск? Наши рекомендации, или чего мы ждали от своих джунов

Учитесь вместе с нами❤️

Всем привет!

Сегодня, 14 ноября, в 19:00 по московскому времени пройдёт митап для технических писателей, организованный коллегами из Cloud․ru.

О чём пойдёт речь?

🔴 Юлия Служаева из Cloud․ru расскажет о редполитике: как написать правила и не устроить бои без правил.

🔵 Марина Смирнова и Екатерина Каляева из Cloud․ru поделятся, как они автоматизировали проверку документации: кейс с линтером Vale.

🟢 Антон Литвинов из SberDevices поговорит о системе метрик клиентской документации.

🟠 Теодора Малевинская из T-Bank расскажет о частых ошибках техписателей в поиске работы.

Ссылка на онлайн-трансляцию появится в канале TeamSnack TechWriters, не пропустите :)

#анонс

#какэтоработает
Всем привет! Сегодня поговорим о том, с чем техписатели чаще всего не работают, но что всё равно находится в их сфере влияния, и поделимся полезным шаблоном.

Постмортем. Что это и для чего

Как видно из названия, постмортем — это артефакт, который появляется после критической ситуации, инцидента.

Инцидентами называют событие, при котором сервис частично или полностью недоступен или работает, но совсем некорректно.

❓ Мессенджер упал — это инцидент, потому что сервис недоступен.

❓ В одном из маркетплейсов покупательница смогла заказать товаров на 17 миллионов и получить их без оплаты — это инцидент, потому что сервис работает, но совсем не так, как должен.

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

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

*️⃣Кто пишет постмортемы

Постмортемы пишут инженеры, которые устраняют инцидент и его последствия.

*️⃣Как участвуют техписатели

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

❗️На прошлой неделе мы анонсировали подкаст о постмортемах. Техписалити! совместно с одним из участников подкаста - Кареном Товмасяном, Senior Engineer в Payments @ Uber и автором канала Человек и Машина, разработали шаблон постмортема на основе открытых данных. Этот шаблон можно забирать, адаптировать и использовать бесплатно.