doc: update with an architecture schema - closes #844