Further join() docblock improvements

Add example for array usage, simplify docblocks, fix yoda
conditions and typos