updated readme with gotchas