add notes about some data gotchas