Message 125023 - Python tracker
I concur that the one warning is enough. Implementations have been given wide latitude in this regard. Even within CPython there is not much uniformity -- some funcs/methods don't accept keywords, some will disregard keywords, and others may have keywords that are different from the name in the docs. I believe it would be a mistake to make to lock in the present state of accidental implementation details by documenting them in the main docs.