Технический писатель, работающий с ИИ

ИИ меняет не только то, как технические писатели создают контент. Он преобразует процесс исследования, создания, структурирования, рецензирования, поддержки и оценки документации, меняя саму роль технического писателя. Этот митап исследует практические способы, которыми технические писатели интегрируют ИИ в свои рабочие процессы, от инструментов документации с поддержкой ИИ и навыков до новых подходов к организации и поддержанию контента. Подтвержденный спикер Ane Tröger, PhD Ведущий технический писатель в Bayer Доклад: Создание навыка классификации Diátaxis для Docs-as-Code Описание: В внутренних репозиториях документации, основанных на коде, документация растет органически, а не по замыслу. Страницы добавляются там, где удобно, а не там, где они должны находиться, и в результате получается плоская, не типизированная структура, которую никто не понимает полностью. Миграции платформ усугубляют ситуацию: любая существующая иерархия частично коллапсирует, и контент поступает партиями. Стоимость этого ложится на всех — читатели теряют время в неправильном режиме, писатели теряют уверенность в том, куда уходит их вклад, а инструменты ИИ теряют точность, поскольку смешанные сигналы создают смешанные результаты. Одним из возможных решений является реорганизация репозитория, чтобы упростить поиск информации, облегчить поддержку и потенциально упростить потребление ИИ. Этот доклад расскажет о создании навыка ИИ, который классифицирует страницы документации по фрейму Diátaxis — учебники, пошаговые инструкции, объяснения и ссылки — плюс пятый тип, навигация, добавленный для обработки навигационных узлов, которые содержит каждый настоящий репозиторий. Мы рассмотрим, как структура навыка организована на трех файлах, четырехступенчатый процесс, который он выполняет (читать, классифицировать, разделять, навигировать), и почему он производит уровень уверенности из распределения сигналов вместо оценки «пас/непас» — с низким уровнем уверенности, действующим как флаг смешанного контента. Подходит для технических писателей любого уровня; секции по дизайну навыков и принятию решений наиболее глубоки для опытных специалистов. Основы фрейма Diátaxis и примеры будут кратко рассмотрены, и если вы хотите получить максимальную пользу от этого доклада, я рекомендую заранее ознакомиться с фреймом Diátaxis: https://diataxis.fr/start-here/ Frances Liu Соучредитель, Promptless Доклад: Что агенты ИИ делают неправильно при написании документации Описание: Мы регулярно тестируем пограничные агенты (Claude Code, Codex и OpenCode с открытыми моделями) на задачах документации. Черновики обычно возвращаются отполированными и связными, но их неудачи происходят еще до написания: необходимо ли менять документацию вообще, определить, для кого предназначены документы, выбрать, на какой странице должно быть изменение, и ответить на вопрос, что читателю нужно сделать, а не описать, что делает функция. Мы рассмотрим, какие агенты хорошо справляются с какими задачами, какой контекст увеличивает их шансы на успех и как проверять их выходные данные, чтобы тихие неудачи не достигали ваших читателей. Вы уйдете с контрольным списком для определения того, что передать агенту, и что проверить, когда он возвращает работу.Helena JerneyРуководитель информационного опыта в StreetLight Data Доклад: Информационная архитектура для аудитории ИИ Описание: Что требуется, чтобы контент мог быть потребленным ИИ для обеспечения оптимального пользовательского опыта. Где пересекаются архитектура контента и контекста и как управлять информационным потоком, чтобы удовлетворить потребности и ограничения LLM. Более подробная информация будет предоставлена позже.