doc: Corrected and improved size_hint doc
Merge pull request #2763 from inclement/size_hint_doc

doc: corrected and improved size_hint doc