<div dir="ltr">Please don't clutter executable code. We need to read it without growing an headache.<div><br></div><div>Much better is:</div><div><br></div><div><div><font face="monospace, monospace">      def myfunction(arg1, arg2):</font></div><div><font face="monospace, monospace">      """</font></div><div><font face="monospace, monospace">      Normal docstring...</font></div><div><font face="monospace, monospace">      @hint: (str, int) -> bool</font></div><div><font face="monospace, monospace">      """ </font></div><div><font face="monospace, monospace">          return True</font></div></div><div><br></div><div>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:</div><div><br></div><div><div><font face="monospace, monospace">      def myfunction(arg1, arg2):</font></div><div><font face="monospace, monospace">      """</font></div><div><font face="monospace, monospace">      Normal docstring...</font></div><div><font face="monospace, monospace">      """</font></div><div><font face="monospace, monospace">      "@hint: (str, int) -> bool"</font></div><div><font face="monospace, monospace">          return True</font><br></div></div><div><br></div></div>