Added some notes on the API