Update CC API to correct typos, add to App Arch info

NB cloudcontroller-ng/doc PR also submitted to fix the source of the API docs.
TODO split API doc down per entity.