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).