Документация и код

Документация на ПО содержится в коде.

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

Это не значит, что документация вообще не нужна. Общие концепции и архитектура меняются не так часто, как детали поведения системы или список функционала. Поэтому для общего знакомства с системой документация все же необходима, но все ответы о том, какое поведение от ПО ожидается в той или иной ситуации, находятся в коде.