Updated docs according to changes in #138

Updated docs to reflect changes in #138 
documentation is my kryptonite, ill stick with any final suggestions you have for me :wink: