Api improvements

I've cleaned up the docs a bit more and removed an unneeded public function.