rename public interface, add docstring