Редкие комментарии - это не отсутствие комментариев.
А вот в самодокументируемый код я верю слабо. Почти не верю. Т.е. понимаю, что бывает, но не верю ни в одно отдельно взятое заявление. ;)
А если логика раскидана между кодом на пых-пых (не, для пых-пыха это вполне приличный ООП-код) и описаниями в разных XML-файлах (ну а за пониманием того, как образуется страница, надо лезть в сундук Пандоры под названием XSLT - это ж такая дивная весчь, где для увернности в том, какой шаблон вызовется, надо зенать точно, что нигде не завалялся неизвестный тебе вариант, который окажется приоритетнее всех известных)...
Я уже задолбался. :(