std.algorithm: Document sort's predicate expectations
Merge pull request #1691 from CyberShadow/std-algorithm-sort-ddoc-nan-warning

std.algorithm: Document sort's predicate expectations