Please don't clutter executable code. We need to read it without growing an headache.
Much better is:
def myfunction(arg1, arg2):
"""
Normal docstring...
@hint: (str, int) -> bool
"""
return True
While I agree type hinting, for the purposes of static analysis, has no place in __doc__, I think that we could live with that. Otherwise:
def myfunction(arg1, arg2):
"""
Normal docstring...
"""
"@hint: (str, int) -> bool"
return True