Suggested changes from Dave and Mate

* Refer only to Python API parameters
* explain the heat map
* explain stbt-debug

Also: summary of second pass added to end of section
Various markup changes (italics, bold, etc)