- add more explicit docs for relationship mixin, [ticket:2876]