added gotchas to docs