documentation update for issue #3047 (throws exception in case of non-comparable)
Merge pull request #3431 from serkan-ozal/fix/3.x/issue-3428

documentation update for issue #3047