doc: corrected and improved size_hint doc

Would resolve https://github.com/kivy/kivy/issues/2707