update the architecture documentation