added more notes on architecture