add doc of decision api