docstring fixes and making API public