каменты должны описывать не "что и как тут делается", а "накуа оно тут надо". без таких комментариев никакой самодокументированный код не поможет понять, что тут вот мы багофичу проца обходим, тут вот глюк сторонней железки, а тут вот этот битик дёргаем так, потому что бля тут так заведено издавна.