[doc] Improve documentation of join generic function and method
Merge pull request #396 from abeaumont/documentation-join

[doc] Improve documentation of join generic function and method