Технічний письменник в епоху ШІ

ШІ змінює більше, ніж просто те, як технічні письменники складають контент. Він перетворює спосіб, яким ми досліджуємо, створюємо, структуруємо, переглядаємо, підтримуємо та вимірюємо документацію, змінюючи при цьому саму роль технічного письменника. Ця зустріч досліджуватиме практичні способи, якими технічні письменники впроваджують ШІ у свої робочі процеси, від інструментів документації, що працюють на базі ШІ, до нових підходів до організації та підтримки контенту. Підтверджений спікер Ане Трегер, PhD, провідний технічний письменник Bayer Доповідь: Створення навички класифікації Диулатаксу для Документів як Код Опис: У внутрішніх репозиторіях документації як код документація, як правило, розвивається органічно, а не за дизайном. Сторінки додаються там, де це зручно, а не там, де вони належать, і в результаті це призводить до плоскої, не типізованої структури, яку ніхто не розуміє повністю. Міграції платформ погіршують ситуацію: будь-яка ієрархія, що існувала раніше, частково руйнується, а контент приходить партіями. Це обтяжує всіх — читачі витрачають час не в тому режимі, письменники втрачають впевненість щодо того, куди йде їхній внесок, а інструменти ШІ втрачають точність, оскільки змішані сигнали породжують змішані результати. Одним можливим рішенням є реорганізація репозиторія таким чином, щоб інформацію було легше знайти, легше підтримувати, і потенційно легше споживати ШІ. Ця доповідь проведе через побудову навички ШІ, яка класифікує документаційні сторінки відповідно до рамки Диулатаксу — навчальне, інструкція, пояснення та довідник — плюс п'ятий тип, навігація, доданий для обробки навігаційних вузлів, які містить кожен реальний репозиторій. Ми розглянемо, як побудована навичка по трьом файлам, чотирьохетапному робочому процесу (читати, класифікувати, розбивати, навігувати) і чому вона виробляє рівень впевненості з розподілу сигналів замість вердикту «зараховано/не зараховано» — з низькою впевненістю, що виступає як прапор змішаного контенту. Підходить для технічних письменників будь-якого рівня; розділи з проектування навичок та прийняття рішень найглибші для досвідчених фахівців. Основи рамки Диулатаксу та приклади будуть коротко висвітлені, і якщо ви хочете отримати максимум від цієї доповіді, я пропоную ознайомитися з рамкою Диулатаксу заздалегідь: https://diataxis.fr/start-here/ Франсіс Ліу, співзасновник Promptless Доповідь: Що агенти ШІ роблять неправильно при написанні документів Опис: Ми регулярно тестуємо фронтові агенти (Claude Code, Codex і OpenCode з відкритими моделями) на завданнях документації. Чернетки зазвичай повертаються політизованими та зрозумілими, але їхні невдачі сталися ще до написання: вирішуючи, чи потрібні документи взагалі, розробляючи, для кого призначені документи, вибираючи, на якій сторінці зміна мала б бути, та відповідаючи на питання, що читачеві потрібно зробити, замість того щоб описувати, що робить функція. Ми пройдемо через те, які агенти витримують які види завдань, який контекст підвищує їх шанси на успіх і як переглядати їхню продукцію, щоб тихі невдачі не дійшли до ваших читачів. Ви покинете зі списком перевірки, щоб визначити, що передати агенту і що перевірити, коли він повертає роботу. Гелена Єрні, керівник інформаційного досвіду в StreetLight Data Доповідь: Інформаційна архітектура для аудиторії ШІ Опис: Що потрібно, щоб контент споживався ШІ для забезпечення оптимального користувацького досвіду. Де перетинаються архітектура контенту та контексту та як управляти інформаційним потоком, щоб задовольнити потреби та обмеження великих мовних моделей. Більше деталей буде згодом.