Architecture document clarifications