Update phrasing and organization of code style guide

//cc @jagtalon @mattr555 @mwmiller

Thoughts?

I couldn't think of much/anything to add to the Perl right now but please feel free to lend suggestions or fill it in if you have something.

Regarding the JavaScript Structure part that I removed, I'm thinking it should be moved to the Spice code/design style guide, but perhaps it should just be on this page in a "Spice" section. I just felt it's not immediately important to the topic at hand which is a little more basic.
Not that it matters much, but I believe it's actually "Well-documented."

"Comments should primarily document the _intent_ of the code.  Reviewers are much more effective when they know exactly what you were trying to do. Meaningful variable names also help to document your intent."