s4-join: add some documentation