moved helpers to static methods; updated docstrings