Document ReflectionParameter/Property getType

What's the difference between `getTypehintText` and `getTypeText`?

Also this is my first attempt to document not yet existing functions/methods. So I am careful and send a PR instead of pushing.

Fixes #270 

@joelm We can talk in IRC tonight so I can tell you my doubts. That probably is easier than reviewing the whole diff.