Fixing type hint.
Adding documentation since {@see} is not enough.
Fixing documentation (as well as Sami can do, anyway).