Updated gotchas to include better function docs