add some API notes