document the need to clear caches after updating

After saving changes to a field configuration, even though changes are saved to database, queries will continue to use cached query until a subsequent cache clear reloads global settings from the database. (I'm on D7 for this site so did drush cc all which fixed it for me.)