@AlSweigart When I ask it to generate doc*tests* and it misunderstands what the function is for, then I know that either it poorly named, poorly designed interface or it needs documentation.
It does fine if all you want is to copy the typing metadata to the docstring so that tools that use it, have it.