[vineet]

The WHY is definitely important. But, it is also important to include the HOW the code works (as opposed to just WHAT the code does) and HOW to use the component.

I find it useful to think of three four questions as a good checklist when reviewing code. Naming often helps in only one of the above.