Конференция завершена. Ждем вас на KnowledgeConf в следующий раз!

Вам кажется, что с вашей документацией что-то не так? Вам не кажется Софт и платформы управления знаниями, автоматизация процессов управления знаниями

Доклад принят в программу конференции
Семён Факторович
documentat.io

Пять лет писал на C++, а потом добровольно и осознанно стал техническим писателем (да, так бывает!).

С 2012 до 2018 руководил отделом технической документации в Zodiac Interactive.

В 2018 году вместе с партнером основал компанию по заказной разработке документации и консалтингу в этой области.

Telegram @factorized

Twitter @lazeez
Тезисы

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

Документация на API вроде бы есть, но разработчики всё равно приходят с вопросами о том, как им пользоваться. Корпоративный Confluence — хаотичное хранилище разношерстной информации, в котором непонятно, как искать. Заметки об архитектурных решениях в продукте хранятся в гугл-доках, которые ровным слоем рассредоточены по личным GDrive разработчиков. Пользовательская документация в последний раз обновлялась при Медведеве, и её все равно никто не читает.

Если у вас всё не так — вы молодцы! Если у вас всё именно так, то не расстраивайтесь: это системные проблемы, встречающиеся в очень большом количестве компаний.

Мы поговорим вот о чем:
- как навести порядок в документации и какие процессы могут этому помочь;
- какой человек может возглавить работу по этой важной задаче (да, это именно технический писатель);
- какой у этого человека профессиональный профиль, как его найти и как вырастить.

Другие доклады секции Софт и платформы управления знаниями, автоматизация процессов управления знаниями