Document join behaviour for multiple matches.
Closes #320
Improve join docs