[Issue 23320] New: Operator overload comparison docs needs improvement

[d-bugmail at puremagic.com]

https://issues.dlang.org/show_bug.cgi?id=23320

          Issue ID: 23320
           Summary: Operator overload comparison docs needs improvement
           Product: D
           Version: D2
          Hardware: All
                OS: All
            Status: NEW
          Severity: enhancement
          Priority: P1
         Component: dlang.org
          Assignee: nobody at puremagic.com
          Reporter: alphaglosined at gmail.com

Currently, the documentation for operator overloads that are used for
comparison is a bit of a wall of text without any concrete examples for the
primary section.

Furthermore, Paul Backus on Discord showcased the paper "Inflationary Constant
Factors And Why Python is Faster Than C++" by Mehrdad Niknami which
demonstrates some excellent performance comparisons between two different types
of comparison operators. It would be good to mention this.

--