apigenerator: add some important notes