Функции документов и способы документирования
Как читать чужую проектную документацию, не осуждая, а улучшая
Чужую проектную документацию часто читают так, будто нашли на месте преступления папку с уликами. Комментарии появляются быстро: «кто это согласовал», «зачем так сложно», «тут ничего не понятно». Проблема только в том, что документ обычно не пишет один человек в тишине и здравом уме. Он рождается между созвонами, правками, срочными решениями и фразой «пока зафиксируем так». Поэтому читать его лучше не как обвинительное заключение, а как карту чужой борьбы с реальностью. Чужая проектная документация — это особый жанр литературы...