Agreed. Any developer should, as painfully as it might be, be able to tell what a block of code does. The intent is hard to establish. I think that it is much more productive to document intent. Intent, to me, is a union of what you’re doing and why.