updated doc. Fixed vocabulary, replaced diagrams.