added some notes on usage