format changes for readability

Sidekick: @nathanhumbert 
FYI: @Sheeri

I made some formatting changes for readability and added some more examples in. Renamed a couple new variables for consistency. Thanks again @Sheeri