>> I can see what the code is doing. I don't think the reader should have to look at the code to get the summary of what the code does and how it does it. I a

>> I can see what the code is doing. I don't think the reader should have to look at the code to get the summary of what the code does and how it does it. I agree that the "why" should be the focus.