Updated docs given suggestions/corrections by @mastfish