Issue108 durack1 update doc readme dot md

@doutriaux1 @gleckler1 some tweaks.. I'll likely keep committing small changes to this..