more descriptive doc string for is_successful