polished docstrings and defined overlap