Как сделать, чтобы базой знаний начали пользоваться человеческие люди

[KeMik]

Спасибо за статью. Приятно видеть что есть люди понимающие важность документации.
Из личного опыта могу добавить что у себя сделал обновление документации частью процесса разработки. В каждой фиче есть подзадача о том что после завершения разработки нужно добавить или обновить существующую документацию: подправить архитектуру, добавить детали реализации в описание фичи в Wiki и т.д. Эта задача как и любая задача разработки должна пройти ревью (быть просмотрена и понята другим членом команды в идеале не задействованным в работе над этой фичей). При таком подходе у нас документация всегда в актуальном состоянии и при этом время на написание документации запланировано в работу над фичей и обычно не требует больших трудозатрат, да и делается по свежей памяти а не через пол года после релиза.

[Coob]

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

Когда стал тимлидом, для своей команды ввел необходимость подбивать документацию сразу после релиза (после релиза как раз становится немного посвободнее со временем). У QA есть своя специфика, но опыт говорит, что в итоге примерно одно и то же будет интересно и девелоперам, и QA, и техписателям, и техподдержке.

[DariaSha]

Отличные мысли и советы! Спасибо, что поделились опытом. Я — техписатель, и передо мной и моей коллегой сейчас стоит задача поддерживать и продвигать нашу базу знаний как внешним пользователям, так и внутри команды. Многие из ваших советов, скажем так, облегчают мою боль. Мы уже пытаемся сделать базу знаний единым golden source и сделать ее удобной для пользования (структура, кросслинковка).
Понравились идеи вот в этом разделе «Угрозы, вымогательства» и вот в этом «Играйте на здоровом самолюбии» :)