code review changes. thanks Zack Meril!

-- make doc strings actual doc strings
-- use when. `<` is a predicate that has arity >= 2!
-- remove extra filter, (not= 1 nil) => true
spaces look better than Xs