Twenty Twelve: review and clarify code comments

[jorbin]

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

[lancewillett]

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

[lancewillett]

In [21617]:

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

[lancewillett]

In [21618]:

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

[DrewAPicture]

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​

[DrewAPicture]

Re-closing as fixed.