Documentation is like sex:
when it is good, it is very, very good;
and when it is bad, it is better than nothing.
вольный перевод: документация, как секс, когда документация хорошая - это очень очень замечательно... когда документация плохая - это лучше чем ничего.
Вот уже третий год я занимаюсь обратной разработкой (reverse engineering) - пытаюсь по коду без комментариев, используя ряд обобщений и неполную индукцию написать систему, которая работает "как надо". Единственное, блядь, желание - это взять и прочитать, хоть где-нить о том "как надо". Выход из сей ситуации видится таким: самому поместить в свою голову все бизнес-процессы происходящие на типичном торговом объекте.... но мне столько не платят.
в общем, пичаль.