Describe the feature and motivation
The comments in cv2/typing/__init__.pyi would be beneficial as actual docstrings:

vs

Additional context
This may be useful in other stubs too where there's comments, as long as it doesn't override existing docstrings