add api definitions as comments