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

Бывает, действительно хотят как лучше.
Imho тут как в программировании - иногда у разработчика может быть соблазн
сделать что-то красиво, применив сложный синтаксис и какой-нибудь малоизвеcтный финт. Но в конце концов часто побеждает более "дубовое" решение, которое легче сопровождать последующим поколениям.

На самом деле после определенного опыта работы пришел к решению, что надо все документировать как можно больше и подробнее.
В общем, если и делаешь како-то "выкрутас" - то достаточно его описать и ОК.