Техниндзя

Неделю назад был День знаний, в который я, по иронии судьбы, получил самое настоящее новое знание: впервые в жизни самостоятельно подключил новую стиральную машину! 🥳

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

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

Прочитал пару раз, снял транспортировочные болты, подключил слив, присобачил заливной шланг и — о чудо — ЗАРАБОТАЛО! Я сидел, смотрел, как крутится барабан (стиралки, не Якубовича) и думал: «Как это прекрасно…» 😍

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

Так что вас — с давно прошедшим Днем знаний, а меня — с обновкой и маленькой личной ачивкой 🤪

P.S.: оглядываясь на недавний флуд в желтом чате про варианты работы вне IT, подумал о том, что если не техписателем, то мог бы работать «мастером на час», хотя бы по стиралкам… 🤔

Так, вы же не думали, что я остановлюсь на разборе UX разных блюд и ассоциаций техписательства с поп-культурой? И не думайте, сегодня во внеочередной рубрике «Дед забыл выпить таблетки» «Мюсли вслух» попробую соотнести сегментацию тех. документации со «Смешариками» 😳

Ну, сами посудите: это не мультфильм, а готовая методичка по типам пользователей доки. Каждый смешарик пользователь со своим стилем потребления контента и если писать доку «для всех сразу», не выйдет угодить никому:
🟣 Крош (кролик-СДВГ-шник). Он прочитает первый абзац и побежит делать. Ему нужен TL;DR, кнопка «сделай уже» и ноль предисловий про то, зачем это все придумано. Если дать ему простыню контекста, то он закроет вкладку с докой на второй строке.
🟣 Копатыч (превед медвед). Идет по инструкции строго по шагам, от первого до последнего, и звереет, если пропущен хоть один пункт или порядок действий скачет. Идеальный тестировщик пошаговых гайдов: если Копатыч застрял — застрянет любой.
🟣 Пин (пернатый с говором немецкого водопроводчика). Ему не нужна не история про «зачем», а точный референс: какие параметры, какие типы данных, что возвращает эндпоинт. Лирика про пользу продукта его только раздражает, поэтому его сразу нужно отправлять к API-справочнику.
🟣 Совунья (nuff said). Эксперт, которая читает документацию и морщится от слова «просто». Для нее «разжеванный» текст выглядит как неуважение к ее опыту — ей нужен хардкорный режим, а не повторение матчасти.
🟣 Нюша (которая свинья). Ей важно не «как это работает», а как это будет выглядеть и ощущаться в итоге: красивый пример, скриншот готового результата, картинка «до/после». Сухая техническая логика без визуала ее не зацепит.

Пять смешариков = пять разных типов читателей одной документации. Из этого, кстати, теоретически может произрастать и идея Diataxis: tutorial для Кроша, how-to для Копатыча, reference для Пина, explanation для Совуньи.
(Для свиньи, к сожалению, отдельный тип документации пока не завезли 🤷)

Так что перед следующим командным мозговым штурмом на тему «а надо ли это объяснять подробнее» просто задумайтесь: а для кого мы сейчас пишем, для Кроша или для Совуньи? Ответ обычно все расставляет по местам 😮

Привет-привет! 👋
 
Сегодня расскажу историю про то, как когда-то я пытался понять «Дюну» и как это связано с техписательством.
 
Начал я с фильма Дэвида Линча 1984 года, досмотрел его до титров и понял одно: там были огромные черви, какая-то приправа хмели-сунели и много шумихи из-за нее. Остальное для меня выглядело как какой-то поток сознания, в котором я так и не разобрался (хотя, признаюсь, другие фильмы Линча мне заходили на ура).
 
Ну ладно, подумал я, наверное, дело в экранизации. Решил почитать роман Герберта и тут началось… Много страниц с описанием политики, генетических приколов от Бене Гессерит и внутренних монологов героев. Я пытался до последнего осилить и разобраться во всем, но в конце концов плюнул и, вспомнив совет приятеля, закрыл книгу, чтобы больше никогда ее не открывать...
 
Совет простой: «Если тебе не нравится книга, которую ты читаешь — закрой ее».
 
Вскоре после этого мы с женой пошли в гик-бар и там нашли комикс по «Дюне». Я пролистал его и (не поверите) даже комикс умудрился быть занудным! 😳
 
Спасли ситуацию только фильмы Дени Вильнева. После них я, наконец, начал примерно понимать, кто такие Атрейдесы и Харконнены, почему такой сыр-бор из-за хмели-сунели и, собственно, кто на ком стоит. История Пола Муаддиба вообще-то прикольная, просто ее экранизировали по-человечески только в этом десятилетии.
 
И вот тут до меня дошло: а ведь Фрэнк Герберт, возможно, просто не подумал о своей целевой аудитории и написал гениальный продуманный мир для узкого круга фанатов sci-fi с дипломом по политологии 🤔
 
К чему это все? Нам, техписателям, не положена такая роскошь. Мы не можем сказать пользователю «пробейся через 400 страниц первоисточника и поймешь». У нас есть ровно одна попытка объяснить, как настроить переменные окружения или получить токен для авторизации, и если пользователь не понял с первого захода, он не пойдет читать комикс, а просто закроет доку, чтобы больше никогда ее не открывать...
 
Так что знать свою ЦА — это обязательно. Иначе Бене Гессерит даст вам подзатыльник 😄

P.S: фанаты «Дюны» и Герберта, не обижайтесь, пожалуйста 🤪

Привет-привет! 👋

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

Прочитав намедни пост о рабочем вайбе с канала «Спросите Киру», я вспомнил историю: в прошлом году откликнулся на вакансию в одну известную компанию, прошел беседу с HR, затащил тех-собес и лайв-докинг, отсидел финальную беседу. Но вместо оффера получил отказ с формулировкой о том, что «по вайбу (они на полном серьезе использовали это слово) и ожиданиям от совместной работы они мэтчатся с другим кандидатом».

Честно признаюсь, тогда меня знатно покорежило от «молодежного англицизма» в официальном ответе, но спустя время мне перестало такое казаться нелепой блажью по типу гадания на таро или гороскопов.

Можно быть технически подкованным везде и сразу, можно с полпинка разобраться в сложном продукте, можно знать тонкости своей профессии на маниакальном уровне вовлеченности, но не «сойтись характерами» с командой 🤷🏻

Документация — штука очень командная. Вы постоянно общаетесь с разработчиками, продактами, дизайнерами, обсуждаете формулировки, спорите за термин в глоссарии. Если по «вайбу» не совпали, то даже самая вылизанная структура доки не спасет рабочие отношения.

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

Хм, что-то я отошел от темы 🤔

Возвращаемся к каналу Киры и другому посту о найме дизайнера, где вместо привычного тестового HR просила прислать пять мемов, с которых искренне смеешься, и вся команда смотрела, чьи мемы больше всего заходят. Мягко скажу — весьма странное тестовое. С другой стороны, совпадение чувства юмора тоже решает. А как иначе разряжать обстановку в рабочих чатиках? 💛

Имхо, та команда, где вместе ржут над одними мемами про «улиточка, новые правки» и «баг = фича», обычно и правда тащит одинаковый темп и понимает друг друга с полуслоненок полуслова.

Короче говоря, решил устроить мини-версию такого теста в комментариях. Накидайте свои любые мемы (не обязательно про техписательство, главное — те, с которых вы искренне угораете). Я подкину свои, оценим общий вайб и просто посмеемся над смешными статичными картиночками ⬇️⬇️⬇️

Несу вам анонс годного мероприятия.

Команда RWB (объединенная компания Wildberries & Russ) анонсировала свой первый митап по технической документации. Он состоится уже в этот четверг.

Программа прям очень вкусная:
🟣«Летопись документации разработчиков WB API» — Лидия Рудакова, которая лидит команду документирования Public API
🟣«Единая система оценки задач техписателей: как внедрить новый подход без боли» — Евгения Красильникова из команды разработки документации и методик обучения ПО
🟣И на десерт: «100 к 1: Как организовать подход "документация как услуга" в одиночку» — Антон Гафаров из команды FinTech Infra

Когда: 16 июля, 16:00 Мск
Формат: Онлайн
Цена: бесплатно, но нужно зарегистрироваться

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

Это я к тому, что на той неделе работал над вычиткой статьи, в которой ребята-разработчики советовали годные LLM для работы с кодом, в том числе и GLM 5.1. Углубившись в статью, нашел пометку о том, что вышла модель GLM 5.2 и что ее тоже стоит упомянуть в тексте. То есть первую версию статьи они начали накидывать, когда 5.2 еще не вышла в прод.

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

Честно говоря, на этот счет у меня нет универсального рецепта, но одно наблюдение все же появилось. Учить конкретный инструмент — так себе стратегия, полезнее учить принципы (т.е. как работают ИИ-агенты, зачем нужен контекст, откуда берутся галлюцинации и т.п.).
В общем, бежим и стараемся не спотыкаться, роняя токены из карманов 🏃‍♀️

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

Если вам интересно (или неинтересно) такое, набрасывайте реакции.

🦄 – конечно хочу!
💔 – не, чет не хочу

Глядите, какую нашел штуковину!

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

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

В общем, эта штука определила, что я:
- активист-оппозиционер 💪
- глава Севастополя (севастопольцы, привет 👋)
- нападающий ФК «Торпедо» 💪

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

Пробуйте, развлекайтесь и кидайте свои результаты в комменты (вдруг вы тоже играете за какой-нибудь «Пахтакор» и не знаете об этом) 😂

Привет! ❤️

В этом году мне сказали: «Есть исследования, что от ИИ тупеют. Ты за собой такого не замечал?» Если отвечать коротко, то «и да, и нет», однако короткого ответа недостаточно. Поэтому начну издалека.

Исследования действительно есть, причем занятные:
🟣MIT Media Lab, Kosmyna et al., 2025 (arXiv:2506.08872) посадили три группы людей (с гуглом, ChatGPT и без них) писать эссе и сняли с них ЭЭГ. У группы с ChatGPT мозговая связность была самой слабой, а свои эссе они цитировали хуже всех. Авторы назвали это «когнитивным долгом».
🟣Но в начале 2026 на ту же статью вышел разбор-комментарий (Stanković et al., arXiv:2601.00856), где коллеги по цеху аккуратно напомнили, что выборка крошечная, методика ЭЭГ спорная, с воспроизводимостью не очень. В первом исследовании, кстати, тоже указано, что это препринт без рецензии и выводы предварительные.
🟣А вот исследование Герлиха (Societies, 2025, 15(6), DOI: 10.3390/soc15010006) — это уже опрос на 666 человек и в нем корреляция между частым использованием ИИ и более низким критическим мышлением действительно нашлась, особенно у молодых. Механизм — «когнитивная разгрузка». Зачем держать в голове, если можно спросить?

Других изысканий не встречал, если вдруг, кидайте в комментарии.

Мое личное «и да, и нет» могу прокомментировать так.

👍: разучился держать в голове целый абзац до того, как начну его печатать. Раньше формулировка вызревала в голове, теперь я сразу набрасываю промпт и редактирую то, что вылезло. Это как с калькулятором — если считать в столбик разучился, то разучился навсегда.

👎: с другой стороны, за годы работы с нейронками у меня прокачался внутренний редактор. Я стал быстрее отлавливать моменты, где текст звучит складно, но не значит ничего — помогли тренировки на кошках текстовой ИИ-шнице. Не «тупею», а перекладываю когнитивную нагрузку. (не «отступаем», а «развернулись и алга!»)

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

А вы замечали у себя что-то похожее: что-то одно явно слабеет, а что-то, наоборот, прокачивается? 💛

Anthropic закрыли доступ к Fable всем пользователям

Это результат требования правительства США закрыть доступ к Fable для всех не-граждан, включая сотрудников Anthropic. Так как у Anthropic нет системы для проверки гражданства, доступ закрыли вообще всем.

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

От того удастся ли Anthropic отбиться и насколько серьёзны намерения правительства зависит судьба рынка.

https://www.anthropic.com/news/fable-mythos-access

@ai_newz

Штош... всех, кто успел попользоваться Fable – поздравляю, хоть и не от всей души. А тем, кто не успел – сочувствую, я тоже не успел 🫤

Привет-привет! 👋

Ну, шо, поздравляю вас с началом лета и надеюсь, что у всех вас оно будет великолепным ☀️

Прошло немало времени (опять) с момента последней публикации, после которой я перешел в офлайн-режим write-only. Зато теперь есть повод отчитаться по делу.

Во-первых, я таки дошел до конца испытательного срока на новом месте и вроде как дошел успешно.

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

Во-вторых, в середине мая я выступил на мероприятии Текст Конф Лайт и если вдруг кто не видел запись, несу ее и презентации. А для тех, кому проще воспринимать связный текст, я написал статью.

Ну а что, если потратил время на подготовку, грех не переупаковать это в текст, правильно? ☝️

А так, я жив, канал жив, и надеюсь, что постов будет больше и я не буду пропадать так надолго. Хотя вы уже, наверное, не верите 😁

ПИШИТЕ ДОКУМЕНТАЦИЮ! СРОЧНО!

Попалась мне вчера просто афигенная новость. И если уж она не убедит людей, которые терпеть не могут писать документацию, то уже, кажется, ничто не убедит🤣

Я даже знаю некоторых системных аналитиков, которые меня уверяли, что писать доку — это бестолковое занятие! А, да?🤣🤣 Пиз….

Новость особенно зайдет тем, кто играл в Ведьмака (да, это я, поэтому вдвойне орнула, когда это читала)

❔ Итак, смотрим:

Техписатели CD Projekt RED рассказали, как плохая документация осложнила разработку ремейка первой части «Ведьмака»

И почему студия решила полностью изменить подход к этому процессу

После проблем с разработкой Cyberpunk 2077 компания провела реорганизацию и одной из главных скрытых проблем оказалась внутренняя документация, которая в CDPR десятилетиями велась хаотично

Во времена оригинального «Ведьмака» студия была маленькой, поэтому сотрудники передавали знания устно — «за чашкой кофе», а не через базы данных

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

Дополнительной ошибкой стало закрытие внутренней вики после выхода «Ведьмака 3: Дикая Охота». Компания решила сэкономить ресурсы и не перенесла данные в другое место, из-за чего часть важной информации была потеряна

Проблема особенно проявилась во время создания REDkit — инструментария для моддеров. Техписателям пришлось искать старые документы через архивы, закрытые серверы и даже случайно найденные скриншоты старой вики

Во время разработки Cyberpunk 2077 ситуация стала ещё сложнее: документация разрослась до 8 тысяч страниц, а ближе к релизу её поддержка снова потеряла приоритет

Дополнительный хаос вызвал перенос части базы данных в «облако», из-за чего информация оказалась разбросана между разными системами. Теперь CD Projekt изменила подход, поэтому для «Ведьмака 4» и Cyberpunk 2 студия ввела обязательные требования к документации

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

Ну что, как вам? Жизненно? 😆

Меняются поколения, появляются новые компании и специалисты, но человеческое "Я работаю на отъ€бись, как и все здесь" — бессмертно! Как и забивание на документирование собственных безумств, которые потом раскапывать другим🤣🤣

Даже такие крупные студии грешат, но и до них дошла вся плачевность ситуации, когда доки нет 💀

Это как до Яндекса недавно дошло, что на проектах всё-таки нужны системные аналитики, и их потихоньку начали нанимать

__________________________________

Что касается меня, то я документацию писать обожаю. Могу этим просто брать и обмазываться🤣

Меня это успокаивает. Во-первых, делаю реально полезное дело, которое потом помогает всем вникнуть в происходящее, а во-вторых, не приходится тонну инфы держать в голове, иначе кукукнуться можно 😱

Руководство приняло правильное решение, когда решили нанять Деву в качестве СА🤣🤣

Буквально вчера закончила объемную доку по критически важному треку во всей компании, отправила на предварительное ревью разрабам — разрабы получили оргазм 🫨

А все потому что неплохо так покопалась в коде, столько всего интересного узнала и зафиксировала. Уже что-то и сами разрабы забыли, но теперь им вспоминать и не придется, потому что есть мои санскриты 😎 Я горжусь своей работой

Это к вопросу о том, надо ли системному аналитику понимать код. Но это уже другая тема для разговора, обсудим позже

А теперь давайте поболтаем…

🔘Как относитесь к написанию документации? Ведете её или нет?))

💪 — Да, обязательно / стараемся обновлять

🚬 — Нет, дока для слабаков

P.S. Ведьмаку 3 вчера исполнилось 11 лет

@vitazaebymba

Я человек простой: вижу пост про документацию и Ведьмака – делаю репост себе 🤪

К сожалению, прямой трансляции не вышло, так что придется нам довольствоваться записью экрана 🤷🏻

Скрипт выбрал своего победителя — им стала @vellnat

Искренне поздравляю победителя! 🥳

Остальным — большое спасибо за участие и прошу сильно не расстраиваться; уверен, что это будет не последний розыгрыш 😉

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

Покорнейше прошу прощения — небольшие технические шоколадки со стримом, вызванные моей жопорукостью (или рукожопостью) 🥲

Стрим немножечко откладывается, где-то до 18:20, прошу запастись еще небольшой толикой терпения 🙏

Привет!

Ненавязчиво напоминаю, что у вас еще есть время, чтобы:
1. Отметиться для участия в розыгрыше
2. Бустануть мой канал 🤪

Отмечаться можно вплоть до 18:00 Мск, так что успевайте запрыгнуть в последний вагон 🙂

Кстати, я вам тут несу анонс одного мероприятия.

16 мая (уже в следующую субботу, охренеть) состоится мини-конференция «Текст Конф Lite», на которой я и другие эксперты порассуждаем о том, как AI помогает или мешает в работе с текстами.

Ребята принесут следующие кейсы:
🔵О том, как сделать из ИИ редактора и ускорить локализацию с помощью простого советского... грамотного промптинга
🔵О том, как создать помогатора-уведомлятора и редактора для статей базы знаний
🔵О том, как внедрить AI в локализацию и проверку переводов
🔵О том, как писать учебные курсы с помощью AI

Я, в свою очередь, расскажу, как собрал команду AI-балбесов на базе OpenClaw и управляю ими через чатик в Telegram 😮

Звучит заманчиво, ящетаю. И главное: 🥳

Начало в 12:00 Мск. Ссылочка на регистрацию здесь (ну, вы знаете, что делать 💛).

Привет-привет! 👋

Надеюсь, вы хорошо отдохнули за первую партию праздничных дней.

Как вы помните из моих историй, перед праздниками до меня доехала прекрасная книга от прекрасной @ushkatia. Причем доехала аж в двух экземплярах 😱

В связи с чем объявляю розыгрыш второго экземпляра!
(если что, с Катей эта акция согласована)

Что требуется для участия:
1️⃣Быть подписанным на мой канал
2️⃣Отметиться в комментариях к этому посту
3️⃣(опционально) Поддержать канал бустом – очень хочу его оформить красивенько и добавить кастомных эмодзи 🤪

Итоги конкурса: давайте после праздников 11.05 в 18:00 Мск я запущу беспристрастный и независимый скриптец, который выберет победителя.

Всем удачи! 🙌