Note about typecasting.

As typehinting is not entirely free, we only typehint public methods.
It is also adviced to only typehint type array and object.
This adds a small note in the conventions section.