Внезапно оказалось, что пишу с личного аккаунта. Продолжу с рабочего.
Замечательной практикой является привлечение специалистов из различных областей к написанию документации. Как ранее и говорил - хранителями знаний являются все, а в большом проекте сложно понять, какая информация может понадобиться, какой вопрос возникнет ещё, поэтому отражение информации о проекте с различных перспектив может здорово помочь.
Нашей команде очень подошёл подход "Документация как код". Т.е. разработчики пишут свой код, документируют его, аналитик в формате RST в том же репозитории пишет документацию, сотрудники тех. поддержки как и саппорт в формате RST пишут нюансы своей работы и в конечном итоге автоматически всё это конвертируется в html, заливается на сервер с документацией и знания всех членов команды теперь доступны из единого и удобного интерфейса.
В качестве генератора документации мы используем Sphinx.