Partial fix for issue 8087: improve std.algorithm documentation

Partial fix for: https://issues.dlang.org/show_bug.cgi?id=8087

Various improvements to std.algorithm documentation.