Minor documentation changes
Whitespace

@robb, why did you decide to box the `NSComparisonResult` in an
`NSNumber`?
Remove unnecessary `nil` checks