notes on the design - will be updated