Twenty Twelve: review and clarify code comments

[jorbin]

Some functions are mis documented and others could be a bit more verbose

Thanks—will review and get the clarifications in. Except maybe the anteater comment. :)

In [21617]:

Twenty Twelve: review and clarify code commenting and documentation. Props jorbin and obenland. See #21675.

In [21618]:

Twenty Twelve: review and clean up end-of-element HTML comments. Props obenland for starter patch. Closes #21675.

I've attached some cleanup diffs for consideration per @lancewillett's go-ahead. A great deal of this is spacing out blocks of markup and code so it's more readable and easier to follow. Mixed in are several missing end-of-element HTML comments and a couple of typo/grammar fixes. I've grouped the changes into multiple diffs so it's easier to take or leave some but not all.

• twentytwelve-archives.diff​
• twentytwelve-content.diff​
• twentytwelve-head-foot-side.diff​
• twentytwelve-misc.diff​
• twentytwelve-templates.diff​

Re-closing as fixed.