Update doc to match current API behaviour