update

some more typo's, structure and wording updates
Update for pull request