The candidate_friends scope is (properly) composed of
two other scopes at a same level of abstraction.
The candidate_friends scope does not itself do any scoping
or add anything to the query. It just composes the not_friends
and not_self scopes.
Updated User class definition in the documentation
Merge branch 'composed-scopes'