Document DoubleEntry::balance

Provide examples and describe arguments to the `DoubleEntry::balance` method.

A bunch of formatting pedantry also. It seems yardoc doesn't follow its own documented behaviour. `@param` tags only work when ordered type _then_ name.

http://rubydoc.info/github/envato/double_entry/957c36a/frames