clarify classes named after internal php types

[dbu]

put the answer from #10399 into the documentation

i guess for number and double, there is no workaround?

[stof]

number is not an actual PHP type but a pseudo-type defined in phpstan (and psalm) meaning int|float. So the workaround is to use the union type directly if you have a Number class in the same namespace.

For double, PHP has 2 names for this internal type: double and float. So when you have a conflicting class in the same namespace, you can use the other name (if you have conflicting classes for both names, you are out of luck).

[dbu]

thanks @stof , i added your notes into the pull request.

[dbu]

@ondrejmirtes can you merge this? or do you have more feedback?