Iss343

Updated documentation. If you're reading this, look over the comments and let me know if what I typed makes sense to you. 

/CC @beardlybread