add comments for new functions in connectivity module