Improve documentation on comparison operators.

Explain the difference between `opCmp` and `opEquals`, when to use which, and the rationale behind them.
Fixed in new PR: https://github.com/D-Programming-Language/dlang.org/pull/622