Мишка в курсе: Технический писатель

У вас есть текст, идея книги или уже готовая рукопись? Давайте вместе сделаем так, чтобы о ней узнали читатели! 🟣25 августа стартует курс «Бренд автора» — для писателей художки и нон-фикшн, которые хотят, чтобы их книги читали, а издатели — звали. На курсе вы разберёте, как определить свою аудиторию, сформулировать авторское позиционирование, подготовить заявку в издательство, выстроить контент вокруг книги и поддерживать интерес читателей до и после релиза. ⭕️Отдельный блок посвящён ИИ: как использовать его для анализа, поиска идей, контент-плана и продвижения. ➖Формат — онлайн (потребуется выделить всего 30 минут в день!) ➖Длительность — 1,5 месяца. Для самых быстрых до 30 июня действует промокод brand на скидку 25%. Подробности на сайте.

Всем привет! Не так часто рекомендую что-то в канале, но здесь, как мне кажется, действительно есть на что обратить внимание. Несмотря на то, что курс ориентирован на авторов книг, многие темы будут полезны и техническим писателям: работа с текстом, структурирование информации, понимание своей аудитории и, что особенно интересно, отдельный блок по использованию AI в работе. Сейчас умение грамотно взаимодействовать с AI становится таким же рабочим навыком, как когда-то стали Git, Figma или Markdown. Поэтому думаю, что каждый сможет почерпнуть для себя что-то полезное. Смотрите пост ниже👇

Недавно столкнулись с интересной задачей. С декабря мы фактически не выпускали релиз-ноутсы. Не потому что про них забыли - просто планировалось пересмотреть формат, а потом, как это часто бывает, появились более приоритетные задачи. И вот спустя примерно полгода бизнес снова вернулся с запросом: релиз-ноутсы все же нужны 🫠 Проблема была в том, что нужно было быстро восстановить историю изменений за несколько месяцев. Вручную просматривать сотни тикетов и собирать ключевые доработки - удовольствие сомнительное. В итоге решили попробовать использовать Claude AI. В Jira есть раздел Releases, где можно посмотреть список релизов и связанных с ними задач. Через коннектор загрузили эту ссылки на релизы в Claude и попросили его выделить наиболее значимые изменения по каждому релизу. Например баг фиксы сразу отметаем - изменения слишком мелкие и технические. Конечно, результат нельзя публиковать без проверки. Но в качестве первого прохода инструмент оказался очень полезным: вместо просмотра большого количества тикетов мы получили уже предварительно структурированный список изменений. Дальше оставалось сгруппировать информацию по месяцам, проверить формулировки и собрать всё в презентационный формат (в принципе клод и презентацию может сделать, но все же не всегда получается так как надо). Для меня это ещё один хороший пример того, как AI помогает не заменить работу техписателя, а убрать самую рутинную и неприятную её часть. Так что, вместо того чтобы тратить часы на поиск информации, можно быстрее перейти к анализу, структурированию и подготовке контента для пользователей 😊

У вас есть опыт, который достоин книги❤️ Бизнес-решения, рабочие методики, управленческие находки. Всё это может стать нон-фикшн текстом, который читают, цитируют и используют на практике. Курс-практикум «Мастерская писателя» поможет написать не художественный роман, а текст, который доказывает вашу экспертность и усиливает вас в профессии. ⭐️Набор уже идет, начинаем 18 мая! Вопрос только один: хотите, чтобы опыт остался в головах тысяч читателей или только в черновиках? 📎Все подробности о курсе собрали по ссылке. До встречи!

Всем привет! Наткнулся вот такой курс по тому, как правильно описать свой опыт и обернуть его в интересную книгу для широкого круга читателей)

Когда документация превращается в свалку Обычно это происходит не сразу, а постепенно. Разные по смыслу статьи оказываются рядом и начинают дублировать или подменять друг друга. Вроде бы это overview — но внутри уже есть куски инструкции. Или это описание интерфейса — но внезапно появляются шаги «что нажать». 🤪 В итоге на уровне UI получается набор статей с размытыми границами: не до конца понятно, куда идти за ответом и чего ожидать от конкретной страницы. Недавно разбирал нашу базу знаний после внешнего ревью. Фидбек был довольно точный: тексты местами звучат так, будто они написаны «в целом про продукт», а не для человека, который хочет быстро решить конкретную задачу. Одно из решений, которое заметно упростило жизнь — жестко разделить типы статей: - Overview — что это вообще такое. Одна статья на сервис, коротко, без деталей. - Reference — как устроен конкретный экран или раздел. Что здесь есть и зачем. - How-to — как выполнить конкретную задачу. Чёткие шаги, без лишнего контекста, то есть те самые приесловутые happy paths 🤩 Звучит вроде как очевидно, но без явного разделения всё это быстро смешивается — и пользователь либо не находит нужное, либо читает в три раза больше, чем нужно. Параллельно собрали небольшой стоп-лист из ~12 фраз, которые не нужно юзать в статьях, и с помощью Claude AI выработали скилл для пруфридинга: прогоняешь текст — получаешь структурированный фидбек с конкретными замечаниями. И, пожалуй, главный вывод: проблема чаще не в том, что люди плохо пишут. А в том, что нет договорённости — что именно мы пишем и для кого. 🌚

Техрайтер-интроверт, когда написал сообщение держателю знаний, мол "подскажи, а вот тут у кнопочки такой туллтип, напиши плиз, что имелось в виду", но вместо короткого ответа буковками в слаке он пишет "давай созвонимся на пару минут, объясню" 😩

🚀 Техписатель: старт и прокачка. Эксклюзивный митап для своих! Мечтаете навести порядок в документации или только присматриваетесь к профессии? 22 апреля собираемся, чтобы разобрать карьерный трек, портфолио, работу с ИИ, а также простые принципы составления эффективной документации. В программе 4 эксперта-практика: 🔹 Арина Балерина (Ментор техписателей, ex-руководитель разработки техдокументации ВКонтакте) “Кто такие техписатели. Как понять, что это ваше. Как стать одним из них” 🔹 Екатерина Павлова (CPO Gramax, спикер конференций - WriteConf, TechWriter Days, Techdoc Meetup) “Мастер-класс: создаем сайт-визитку и портфолио в Gramax”   🔹 Дмитрий Развозжаев (Технический писатель в Ximi Data, автор тг-канала Техниндзя) “ИИ в работе техписателя (тема уточняется)” 🔹 Константин Макушев (Старший технический писатель, Т-Банк) “Паттерны и антипаттерны текста документации” Когда: 22 апреля в 16:00 (МСК) Где: Online Стоимость: Бесплатно Важно: Группа ограничена - всего 30 мест, чтобы сохранить формат живого общения. Успейте занять место: https://clck.ru/3SsJF5

Коннекторы в Claude AI: небольшой, но полезный инсайт Не знаю, как у вас, но я сам про это узнал относительно недавно — и немного удивился, насколько это упрощает работу. Речь про коннекторы в Claude AI. С их помощью можно дать Claude доступ к рабочим источникам (например, Confluence и Jira), и он уже не просто будет отвечать в вакууме, а работать с реальными данными. Например, можно: — подтянуть содержимое тикетов из Jira — проанализировать упоминания фичи в Confluence (главное не увлечься и не перетумачить токены!!! 😁) — собрать структурированный документ: overview, how-to или черновик гайдлайна. Дальше становится ещё интереснее, если использовать это вместе с Claude Skills. Это файл с инструкциями, который обучает Claude AI выполнять определенную задачу по имеющимся у вас в команде правилам. В этом случае результат будет не просто «как получилось», а уже ближе к вашему формату — с нужной структурой, тоном и логикой подачи. По сути, получается такой рабочий процесс: собрал данные через коннектор → получил черновик по правилам из скилла → проверил → добавил скриншоты → готово. Понятно, что это не замена полноценной проработки, но как способ ускорить подготовку первого драфта — Not bad 😎 Если вы уже используете, расскажите как именно 😉 Если нет — возможно, стоит попробовать на каком-нибудь не самом критичном сценарии.

Внедрение AI В компании начинается более системное внедрение инструментов AI в повседневную работу. В частности, активно осваиваем Claude AI - как для повседневных задач, так и для более сложных сценариев. На первом этапе многие используют его как помощника: — для работы с текстами, — для анализа информации, — для быстрых черновиков и структурирования идей. Но дальше планируется двигаться ещё глубже — постепенно вводить суб-агентов Claude, которые смогут автоматизировать часть потоковых процессов, например сборку release notes. По сути, это маленькие специализированные AI-помощники, которые берут на себя повторяющиеся задачи и экономят время. Чтобы быстрее освоиться с инструментом, можно посмотреть бесплатные курсы от Anthropic. Там разбирают основы работы с Claude, принципы эффективных промптов и разные практические сценарии использования: https://anthropic.skilljar.com/ Даже если вы уже используете AI в работе, там можно найти несколько полезных идей и приемов. Иногда небольшая корректировка подхода к промптам заметно меняет результат 😉