updates to document based upon team feedback. V2, baby