documented gotchas