re-org docs & add details on production architecture

bug# 1201494

Change-Id: Ie2bd28a1cb7e9f3408e44e2164d72de2c857fc6a
Merge "re-org docs & add details on production architecture"