We talked about the bad documentation on the original version of this method in #273, and I look forward to the change. I think it might be a good idea to provide correct documentation with this method, though.
If you're uneasy with the mismatch, I see no reason not to correct the other documentation (perhaps in a separate commit) in the same PR and then we can close two issues at once.

(I also think that like the other methods, this one needs its wording updated to reflect how Tasks are generated from the values.)