Indeed I agree that it can be difficult or impossible to squeeze all the important information about a function into its signature! And why bother playing golf

Indeed I agree that it can be difficult or impossible to squeeze all the important information about a function into its signature! And why bother playing golf when that’s literally what the doc string is for? (Obviously you should endeavor to write good names anyway).