Modifying the API to accept a keyword argument is not worthwhile IMO. That means modifying modules like http.client and zipfile (which use the wrong keyword name), and user-defined implementations may become incompatible. The question of documentation is discussed more in Issue 23738. I think one or two people were concerned about using the Arg Clinic slash.