Ушакова — директор буковок

О значимости прилагательных и балансе В Agile Manifesto сказано

Working software over comprehensive documentation

И очень часто люди приводят эту строку в качестве аргумента бесполезности документации. Но! Коллеги, когда ваш софт начнёт работать — тогда да, тогда поговорим. Хотя суть здесь, конечно, в comprehensive — не надо упарываться и документировать каждую строку и каждое действие, надо думать кому и зачем вы что-то объясняете в документации 👾 #этобаза

Завтра начинаем второй семестр в Университете Иннополис с предметом Technical Communication. А это значит, что первый семестр провели неплохо и можно немного поделиться историей его создания 🐸 Муж уже преподавал курс по Flutter, а у меня были другие приоритеты в тот момент, но идея своего курса не отпускала. Это был конец 2021 года (ого). Первые заметки о структуре курса, поиск книг и источников, анализ англоязычных тенденций в техдоке. Тогда я связалась с Университетом и спросила, какие требования к курсу и нужен ли им вообще предмет техдоки. Сошлись, что лучше брать шире — техкоммуникации — и я ушла думать дальше. Прошёл год, курс я всё ещё обдумывала. Не супер активно, но именно так и появился тот мини-заметочник. Сразу обсудили, что курс, если и будет, то будет элективом, поэтому меня никто не подгонял — курс по факту нужен был только мне. В конце 2023 уже Университет связывается со мной, мол, помнишь, у тебя была идея, а нам не помешал бы как раз похожий электив? Тогда я привела в порядок все набросы за два года, сформулировала описание курса, вместе с опытными преподавателями, университетом и ребятами из Ozon причесала программу, и мы ушли на первый круг преподавания 🐤 Не всё было гладко, поэтому не хотелось рассказывать — моя любимая внутренняя борьба перфекциониста и блогера. Но снова договорилась с собой, что перед вторым семестром расскажу подробнее. Всего в курсе три блока по 6 занятий, проект и экзамен. Подробно раскрывать содержание курса я, конечно, не могу — это привилегия студентов Иннополиса. Но подробнее о работе над ним — два поста в заметках ✨

🐈‍⬛ Итак, сборная каналов 🐈‍⬛ Начну с рекомендаций шикарнейших каналов, которыми поделился Стас 🍿 Запасаемся попкорном Канал о сериалах — ребята вели свой подкаст и в канале продолжают рассказывать всякие интересности. Мне понравилось, что посты не просто «классный сериал, хомяк плакал, всем рекомендую», а прям подробные и атмосферные разборы. 🤵 Глеб Борисыч Авторский канал просто о жизни. Глеб в описании канала назвал себя «карликовый писатель» и многие посты у него в формате зарисовок. Обожаю такой формат и сама его несу в своём творчестве — просто остановиться на минуту, просто сфотографировать жизнь текстом. ⛏ Возвращение в Брайдсхед Меня зацепили посты о всяких археологических находках. Собственно, весь канал о находках — живописи, скульптуры, быта средневековья. По крайней мере преимущественно средневековья. Подписываться, если любите разглядывать всякие древности. 🤨 Nevreme Про этот канал я знала, но снова залипла на полчаса. Очень неожиданная тема: грозы в Сербии! Ребятааа, там не только шикарные фото-видео природы, но и метеорологические заметки. Из-за своего увлечения яхтингом, я немного понимаю в формировании разных метеоявлений и очень люблю рассматривать метеокарты вместо прогнозов погоды, поэтому этот канал вполне образовательно применим, так ещё и графически впечатляющ! 🪄 Дальше подборка от техписов 🪄 🎧 Злой редактор, негативный Милена уже появлялась в моих постах, поэтому подписывайтесь, чтобы читать и её канал о текстах и жизни. Мне нравится, что Милена докапывается до текстов вокруг — кажется, это профдеформация и редкий техпис-uxw так не делает, но не у всех получается перемежать это заметками с инсайтами о работе с текстами. Ну и обязательно пишите комментарии к постам Милены! 👨‍🦳 QFE Необычный формат канала: Лена делает посты с теорией и потом квизы к ним. Основная аудитория — техписы, но темы такие, общетехнические. Например, про git, основы архитектуры и всякое другое околотехническое. Мы с Леной тоже делали коллаб не так давно. 📖 Техниндзя Дима — техпис. И Дима — очень полезный техпис! В своём канале он рассказывает очень полезные вещи о документации. И про docs-as-code, и про нейронки: на первом Tech Writers Day тоже рассказывал про ИИ в доке 😁 Дима, а ты приедешь на митап в декабре? Всё ищу поводы познакомиться лично. Подборка регулярной не будет, но я всегда рада узнать ваши контентные предпочтения и рекомендации ❤️

На сегодня только два вопроса: 1. Что там с Notion'ом? 2. Вылетят ли Spirit с TI?

Рубрикатор — не единственное, что происходит за самой рукописью. Кроме него я составила целую редполитику: как обращаться к читателю, какие термины использовать, как оформлять таблицы и схемы. Общий тон получилось сформулировать сразу. Книга для начинающих техписателей, поэтому тон ближе к повседневному, серьёзному, в меру уважительный и не экспрессивный. Ориентировалась на схему от Nielsen Norman Group. Термины выписывала по ходу и фиксировала их написание и значение, чтобы не называть одно и то же разными словами. Например, что пользователь — это тот, кто взаимодействует с продуктом или процессом, а читатель — тот, кто пользуется документацией. Таблицы пришлось формализовать после третьей — поняла, что они не супер консистентны. Такие общие правила полезны в качестве ориентира и снимают часть ступора, когда вроде и нужна схема, а вроде не понимаешь, как именно её сложить. Открываешь заметки, смотришь свои же гайды, работаешь по ним. Так же работает и с документацией — если есть правила оформления, не надо долго думать над каждой статьёй, можно использовать шаблон. Ключевое: «не надо долго думать», а не «не надо думать вообще». Любой гайд — это ориентир, его можно и нужно адаптировать под конкретную задачу. Об этом тоже есть целый раздел в книге.

У сотрудников Ozon есть много классных каналов — скидывала подбороки. И там есть Андрей @hey_andrey. При чём я натыкалась на его сообщения в сообществах до того, как узнала, что Андрей мой коллега. Вери профессионально активный коллега, получается 🐤 У Андрея есть [не]регулярная рубрика — рассказывать о других каналах. «Очень классная идея!» — подумалось мне и написало Андрею. Поэтому не обещаю регулярность, но го попробуем — скидывайте в личку свои каналы любого масштаба, соберу с ними пост на следующую неделю 🐹 А пока — подписываемся на Андрея и смотрим чья книга выйдет раньше: его про выгорание или моя про техписательство 🐸

Пятничная подборка [от того-самого Андрея 👆] прекрасных каналов, на которые подписаться уже сейчас. Вот прямо сейчас, скорее. @o_product Growth-лид европейского классифайда OLX, Яна Доценко на своем канале Про продукт и рост рассказывает подходы к росту tech-продуктов. Например, вы знали, что есть growth-ритуалы? Лично я из ритуалов знаю только бритье. Не будьте как я - идите читать Яну. Бонусом, кстати, можно узнать подробности найма в западные компании — к нему еще можно подготовиться с помощью GPT. @zametki_producta Есть довольно много историй про то, как представители смежных профессий сделали переход в продактерство, но мув из юристов — история редкая. Тем ценнее прочитать мысли от человека, который этот самый мув совершил. Саша — бывший юрист в IT — сменил команду и теперь продакт. В канале Юрист → продакт Саша рассказывает о болях поиска новой работы и, в целом, такого перехода (читал со слезами на глазах) плюс делится рефлексией по этим темам. @fuckitlby Антон, продакт и продакт-дизайнер в МТС, ведет свой канал fuckit + fuckit, где рассказывает о том, как вообще живется рисующему менеджеру по продукту в большой и красивой корпорации (тяжело?). Вот и название для канала выбрал говорящее. Антон без прикрас, кстати, делится мнением и рассказывает про факапы, за что ему уважение. @conflictedproduct Катя Ольхова в своем канале "Конфликтный продакт" рассказывает, как сложно оставаться приятным человеком будучи продактом. Как важна здоровая коммуникация в команде — думаю, вы и сами знаете. Недавно рассказала о том, как можно легко самому стать мудаком-руководителем. Плюс, если вам интересны свежие впечатления от поиска работы, welcome on board, как говорится. @leonid_lapidus Леонид, единственный не выгоревший и сохранивший оптимизм продакт, делится своим опытом у себя в уютном канале Lapidus. А опыт у него ого-го: Леонид был и программистом, и лидом autoQA, и проджектом, и продактом, и лидом продактов, и даже CPO(!). Логично, что идеи и мысли свои он доносит понятным языком, а разброс тем очень широк: от секса и паралича до уровней неопределенности. @hey_andrey Есть ли жизнь в корпах, особенно после стартапов? Стоит ли туда идти и чем это грозит? Что делать, если жопа уже подгорела от работы и коллег? Андрей Чуль, Lead Product Manager в Ozon, отвечает на эти и другие вопросы в своем канале Привет, Андрей.

Уже провели саунд-чек со спикерами, остаётся 15 минут до старта 🚀 Ещё раз ссылки: 🥰 Rutube 😄 VK 😉 YouTube 15 минут — идеальное время, чтобы заварить себе чай или кофе и подготовить место для конспекта. Ведь без полезных идей сегодня точно не останетесь 🙃 Уже ждём вас онлайн!

Уже провели саунд-чек со спикерами, остаётся 15 минут до старта 🚀 Ещё раз ссылки: 🥰 Rutube 😄 VK 😉 YouTube 15 минут — идеальное время, чтобы заварить себе чай или кофе и подготовить место для конспекта. Ведь без полезных идей сегодня точно не останетесь 🙃 Уже ждём вас онлайн!