Architecture documentation & diagrams

TODO: references are broken and figure placement wrong