add re-added those needed for end users
added docstrings