final fixes and cleanup to the architecture doc