first pass at updating docs for new API
more docs
mention sort issue
rename Sort, Max, Min to *By

in anticipation of having plain methods on type which are comparable or
ordered
git ignore
notes about comparable, ordered, etc