update docs through architecture