claryfied doc. some typos