complete the implementation architecture overview
make tildes in the code a bit prettier