added architecture to doc
updated doc re architecture and CLI options