docs: all content, spelling, organization and verbage improved