updates to readme and architecture