added design notes, storage permissions.