Document how `allowedErrorsInNumbers` doesn't work well with numerical equality

[dqnykamp]

See this discussion on allowedErrorInNumbers. The failures and suggestion to use symbolicEquality should be documented.