add notes about data API update signatures