Проблема документирования технических решений обсуждается часто, долго и с большими разногласиями. Широко распространены в зависимости от отрасли два лагеря "формалисты-бюрократы" и "гибкие-либералы".
Из моего опыта аргументы вторых сводятся к утверждениям  похожим на:
- "Документация устаревает быстрее, чем обновляется, поэтому в ИТ системе единственная актуальная документация - это код"
- "Документация нужна только там, где нужно её сдавать. Поэтому необходимо писать только ту документацию, которая указана в контракте"
- "Документация - это дорого и поэтому лучше делать продукт интуитивным"
- "Формализмы - это затраты на их изучение, а рынок настолько широк, что невозможно научить всех. Поэтому лучше писать каждый как умеет."

Первые же говорят о том, что:
- "Хорошая документация должна быть"
- "Документация делает процесс разработки управляемым"
- "При хорошей документации RTFM является эффективным способ обучения сотрудников"
- "Документация обеспечивает возможность поддерживать качество продукта…