join: use vacation example for docstring
join: expand docstring to include left_default and right_default