notes on architecture

need to write this down to get proper modules