updated notes for showcasing on github
Added `explain` function.

Updated formatting and escapes for some of the helper functions.