filter joining nodes

update docstrings