scotts comments/changes to ms

@cboettig made some changes, comments, etc. 

looks really great, sorry took me so long. 

also, started some issues as you've already seen