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