Clean up heat-translator documentation

Several RST formatting errors, added some more content too.

Change-Id: I44a557398e668152c38ddad07c01ea6cd38b65ea
Merge "Clean up heat-translator documentation"