fix typo in join documentation
improve readability of return values in docs