[doc] Add documentation for join generic function and method
Merge pull request #385 from abeaumont/documentation-join

[doc] Add documentation for join generic function and method
[crt] Fix indentation and whitespace/bracketing.