Operator overload comparison docs needs improvement

[dlangBugzillaToGithub]

Richard (Rikki) Andrew Cattermole reported this on 2022-09-02T20:34:45Z

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

CC List

• Nick Treleaven (@ntrel)

Description

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.