updating doc to reflect that a result is always returned