Техписалити!

#мемница

Всем привет в новом году! Врываемся в рабочие будни сразу с серьёзного вопроса: как начать год продуктивно? 1. Вспомните всё: я — технический писатель, я делаю мир лучше 💪 2. Проверьте или составьте план на 2025. Если вы принципиально не составляете планы, то проверьте сроки задач, которые выполняете. Но начало года — время пробовать что-то новое, так что попробуйте хотя бы набросать план 🙂 3. Встретьтесь или созвонитесь с командой, чтобы вместе настроиться на работу 🤝 Начало года — отличная точка, чтобы посмотреть на то, к чему вы хотите прийти через год. И планы — хороший способ структурировать своё время и наметить примерный путь. Подумайте, что вы хотите — это могут быть как рабочие планы, так и личностные, но касающиеся работы. Например, рабочие планы: 🟠 начать и завершить грандиозный проект; 🟠 обновить документацию; 🟠 переделать раздел документации; 🟠 повысить грейд. И личностные: 🟢 понять, как работают облачные сервисы; 🟢 сменить работу; 🟢 начать больше зарабатывать; 🟢 выступить на конференции. Необязательно составлять пошаговый план, но для начала можно составить список хотелок, расставить приоритеты и наметить какие-то сроки. Например: хочу сделать грандиозный проект на работе за первый квартал, к середине года повысить грейд и зарплату, а осенью выступить спикером на митапе. Лучше всего даже такие наброски где-то записать и держать если не перед глазами, то в месте, в которое вы часто обращаетесь. Это важно, чтобы не забыть свои желания, потому что в веренице рутины и работы фокус внимания может сместиться. И к концу года вы обнаружите, что не сделали ничего, что хотели. Но самое главное — соблюдайте work-life balance, иначе любые планы и желания станут уже не так важны. Потому что какой смысл быть лидом или больше зарабатывать, если ты выгорел или сошёл с ума 😏 А как вы начинаете свою работу в этом году?

#мемница С наступающим Новым годом, друзья!🎄 Спасибо, что были с нами — учились, писали, дискутировали, смеялись, а некоторые даже коллаборировались) Пусть в новом году правок будет меньше! А в этом году контент для вас готовили: ⚪️ фея-крёстная техписов Лида ⚪️ повелительница мемов Маша ⚪️ мастер над запятыми Катя а также создательницы визуального контента: ⚪️ хранительница джедайских дизайнерских приемов Света (особенно благодарим за оформление #циталити и #средаразработки) ⚪️ юный падаван в сфере иллюстраторских искусств Камила (наш маскот — именно её творение!) До встречи в 2025!🩵

Всем привет! Сегодня у нас снова интерактивная и предновогодняя #мемница Собрали для вас техписательское бинго не без приколдесов конечно 😄 Забирайте и делитесь с коллегами! А в комментах можете показать, какие страйки вы выбили 😏

#мемница

#twd2 Всем привет! Как и обещали, анонсируем розыгрыш онлайн-билетов от организаторов конференции TechWriter Days. Напоминаем, что Вторая международная конференция технических писателей TechWriterDays пройдет 28-29 марта 2025 года в Санкт-Петербурге в офлайн и онлайн формате. Вас ждут 50+ докладов и мастер классов, 2 дня профессионального общения с 400+ участниками из компаний СНГ и новые знания) ❗️ А теперь о розыгрыше Организаторы разыгрывают 3 офлайн-билета на конференцию TechWriter Days #2. Как принять участие? Всё просто: 🔹Пройдите опрос «О чём хочешь доклад» 🔹Вступите в телеграм-группу конференции. ⚡️Итоги подведут 27 декабря в группе TechWriter Days❤️

#какэтоработает - Заходит продакт в бар к техписателям и говорит: "У нас завтра релиз, нужна дока!" Всем привет! Бывает ли у вас так, как в этой грустной непридуманной шутке? Вот у нас бывало( Как избежать подобных ситуаций? Раннее документирование Shift-left документирование или документирование со сдвигом влево — называть этот процесс можно по-разному. Суть в нём одна: технический писатель приступает к описанию продукта как можно раньше. Когда возможно раннее документирование? 1. Технический писатель интегрирован в команду: он знает продукт, представляет темпы работы команды, примерно понимает, к чему движется команда и у него есть доступ к доске с задачами. 2. В команде выстроены процессы: к задаче с фичёй или к эпику пишется чёткое, полное и протестированное задание. Как мы однажды выстроили процесс с докой, расскажем в одном из следующих постов. Когда приступать к работе? При раннем документировании техписатель составляет черновик документации на основании технического задания. Сделать это можно, когда разработчик даже ещё не взял задачу в работу. В этот момент можно: *️⃣ определить место этой фичи в общей структуре документации, *️⃣ установить её связь с другими функциональностями, *️⃣ составить последовательность действий при разных сценариях. После подготовки черновика нужно дождаться, когда задача перейдёт в стадию ручного тестирования, и тогда убедиться в корректности своих текстов и добавить недостающие скрины. Какие плюсы и минусы? ➕ Документация готова до релиза. ➕ Техписатель может планировать и распределять свою нагрузку, если описывает несколько продуктов. ➖ Он должен быть погружён в продукт, то есть поддерживать постоянную связь с разработкой. ➖ Задача может не попасть в релиз. Но этого минуса нет, если используется docs-as-code и подход одна фича — одна ветка. Просто вольёте эту ветку в нужный релиз. А вы пробовали такой подход? Какие минусы заметили ещё?

#twd2 Всем привет! Делимся новостью: канал Техписалити! стал информационным партнёром предстоящей конференции технических писателей TechWriterDays#2. Мы искренне поддерживаем любые мероприятия, которые помогают техписателям делиться знаниями и опытом, знакомиться друг с другом, находить коллег и единомышленников. 🧐 - А как это отразится на канале? Раз в две недели будут выходить специальные посты с тегом #twd2. В них мы будем рассказывать о том, как найти тему для доклада, как повысить шансы попасть в программу, о том, с какими докладами выступят на конференции наши коллеги и как они готовятся к выступлению — в общем, инсайды и инсайты, и всё то, что интересно и вам, и нам самим. В комментариях или в личку задавайте любые вопросы о конференции, мы обязательно вернёмся с ответами. А чуть позже анонсируем розыгрыш онлайн-билета от оргкомитета конференции.❤️

#мемница

#колонкаредактора #twd2 Техписатель и ИИ Всем привет! Полночи — и, хоть и с недочётами, попытку оживить маскота Техписалити! можно считать успешной) Позвольте немного "бумерского" восторга: возможности современных нейросетей удивляют. Но как они влияют на работу техписателя? Какой он — AI/ML-техписатель? Разумеется, речь не о том, как писать тексты с помощью нейросети. На конференции TechWriterDays#2, которая пройдёт весной, ожидается ключевой доклад Семёна Факторовича "Техписатель—2025". Внутри — подкреплённые результатами большого социологического опроса размышления о том, кто мы, какие мы сейчас и какие будем, в том числе, какое влияние на нашу профессию окажет эта новая предметная область. Секции с докладами об ИИ уже стали привычным делом: в программе конференции доклады о нейромоделях, нейролинтерах. Если вы не можете ждать весны и хотите послушать про ИИ уже сейчас, приходите на митап в Ozon сегодня, 10 декабря, в 19-00. Мест оффлайн не осталось, но можно подключиться к трансляции.

#мемница

#какэтоработает Всем привет! Сегодня поговорим о том, с чем техписатели чаще всего не работают, но что всё равно находится в их сфере влияния, и поделимся полезным шаблоном. Постмортем. Что это и для чего Как видно из названия, постмортем — это артефакт, который появляется после критической ситуации, инцидента. Инцидентами называют событие, при котором сервис частично или полностью недоступен или работает, но совсем некорректно. ❓ Мессенджер упал — это инцидент, потому что сервис недоступен. ❓ В одном из маркетплейсов покупательница смогла заказать товаров на 17 миллионов и получить их без оплаты — это инцидент, потому что сервис работает, но совсем не так, как должен. Постмортемы позволяют выявлять причины инцидента и делать так, чтобы в будущем он не возникал или чтобы был не настолько сложным. Состоит постмортем из нескольких частей и включает описание инцидента, историю его обнаружения, хронологию решения, поиск и указание причин и список задач, которые следует выполнить после инцидента. *️⃣Кто пишет постмортемы Постмортемы пишут инженеры, которые устраняют инцидент и его последствия. *️⃣Как участвуют техписатели Техписатели могут предлагать шаблоны в помощь инженерам, структуру хранения постмортемов и, если это требуется, участвовать в их создании во время и после инцидента. ❗️На прошлой неделе мы анонсировали подкаст о постмортемах. Техписалити! совместно с одним из участников подкаста - Кареном Товмасяном, Senior Engineer в Payments @ Uber и автором канала Человек и Машина, разработали шаблон постмортема на основе открытых данных. Этот шаблон можно забирать, адаптировать и использовать бесплатно.

#средаразработки

#какэтоработает Всем привет! Сегодня поговорим о том, с чем техписатели чаще всего не работают, но что всё равно находится в их сфере влияния, и поделимся полезным шаблоном. Постмортем. Что это и для чего Как видно из названия, постмортем — это артефакт, который появляется после критической ситуации, инцидента. Инцидентами называют событие, при котором сервис частично или полностью недоступен или работает, но совсем некорректно. ❓ Мессенджер упал — это инцидент, потому что сервис недоступен. ❓ В одном из маркетплейсов покупательница смогла заказать товаров на 17 миллионов и получить их без оплаты — это инцидент, потому что сервис работает, но совсем не так, как должен. Постмортемы позволяют выявлять причины инцидента и делать так, чтобы в будущем он не возникал или чтобы был не настолько сложным. Состоит постмортем из нескольких частей и включает описание инцидента, историю его обнаружения, хронологию решения, поиск и указание причин и список задач, которые следует выполнить после инцидента. *️⃣Кто пишет постмортемы Постмортемы пишут инженеры, которые устраняют инцидент и его последствия. *️⃣Как участвуют техписатели Техписатели могут предлагать шаблоны в помощь инженерам, структуру хранения постмортемов и, если это требуется, участвовать в их создании во время и после инцидента. ❗️На прошлой неделе мы анонсировали подкаст о постмортемах. Техписалити! совместно с одним из участников подкаста - Кареном Товмасяном, Senior Engineer в Payments @ Uber и автором канала Человек и Машина, разработали шаблон постмортема на основе открытых данных. Этот шаблон можно забирать, адаптировать и использовать бесплатно.

#анонс Всем привет! Всего через несколько часов у ITRadio в гостях будет Карен Товмасян (Senior Engineer в Payments @ Uber и автор канала Человек и Машина). Говорить будут о том: 🔹 как писать слово «инцидент» 🔹 чем отличается инцидент от аварии, алёрта или бага 🔹 что происходит в процессе починки, чем postmortem отличается от обычного отчёта об аварии. Ещё и офигительных историй на десерт обещают! Трансляция будет здесь и тут сегодня, 29.11.2024, в 17:00 по московскому времени. Подробнее о подкасте читайте на сайте и канале ITRadio. (А ещё там можно вопросы задавать!)

#мемница Я — техпис, во мне сто лиц!

#анонс Всем привет! Несём вам отличную новость: Почти через две недели, 10 декабря, в 19:00 по московскому времени пройдёт митап для технических и UX-писателей — уже шестой Techdoc Meetup, в этот раз организованный коллегами из Ozon! О чём пойдёт речь? 🟡 Анастасия Писнова из Ozon поделится опытом работы с текстом как с проектом. 🟡 Светлана Каюшина из СберТех расскажет, какую пользу ИИ может принести техписателям. 🟡 Павел Костромитин из Т-Банка расскажет о росте команды UX-редакторов и их роли в ренейминге. 🟢 А на круглом столе можно будет обсудить компетенции продуктовых техписателей вместе с коллегами из Ozon, Т-Банка, X5 Tech и VK. Митап будет проходить онлайн и офлайн, и запись тоже будет 🎞 Зарегистрироваться и узнать о мероприятии больше можно по ссылке.

#мемница

#вопросвлоб Всем привет! Несмотря на предновогоднее затишье на рынке труда, продолжаем рассказывать о частых вопросах на собеседованиях. И сегодня у нас вопрос: Что такое синхрофазотрон? Нет-нет, мы не будем говорить о синхрофазотроне) Иногда рекрутеры просят у кандидатов ссылки на документацию с прошлой работы — примеры текстов. По умолчанию подразумевается, что хороший технический писатель знает, о чём пишет. Так вот в вопросе "Что такое...?" вместо синхрофазотрона может оказаться любой термин из вашей документации. Например, что такое динамическая маршрутизация? Конечно, вы не обязаны владеть предметной областью на 100%, но лучше продемонстрировать хотя бы общее понимание термина. Выжтехписатель, и выбор слов для документации должен быть осознанным. Действующие техписатели, ставьте 👍, если знакомы со всеми терминами в вашей доке😉