added docstrings and some join-slot-info accessor helper functions