add some notes on interfaces