updates architecture and documenation