Merge pull request #396 from abeaumont/documentation-join

[doc] Improve documentation of join generic function and method
[doc] Documentation fixes in join generic function and method pointed by @gay