That's extremely useful.

Should it be also stated in documentation? Yes, tooltips alone should not be acceptable. But here they are doing their job; that's why they are called tooltips, because they give you tips about an option that might otherwise feel obscure.

I think it's excellent and descriptive, but I started with computers at the CP/M era.

that looks superb to me! I'm tempted to contribute a patch to generate documentation from the tooltips now.

That is the best possible experience