first pass at revising install notes
full pass through to update install instructions
cleaned up text - this fixes #1170