documentation for the new `with_confidence` would be nice.