incorporated feedback and fixed typos
incorporated feedback and fixed typos

codeship/documentation,codeship/documentation,codeship/documentation,codeship/documentation,mlocher/documentation,mlocher/documentation,mlocher/documentation,mlocher/documentation