23 Jan
2015
23 Jan
'15
11:05 p.m.
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