Python: Inconsistent find_element(s)_by_* deprecation warning and command documentation

[bonafideduck]

🐛 Bug Report

In the python remote/webdriver.py code, find_element_by_id() and many similar commands have this warning:

warnings.warn("find_element_by_* commands are deprecated. Please use find_element() instead")

find_element() and find_elements() have this contradicting documentation comment:

    """
    Find an element given a By strategy and locator. Prefer the find_element_by_* methods when
    possible.
    """

To Reproduce

Look at the code links above.

Expected behavior

Personally, I don't see why the find_element(s)_by_* commands have been deprecated. So I didn't expect to see that warning. If someone has a pointer to a conversation that lead to this decision, I'd like to see it.

At a minimum, I'd like the documentation and code be consistent.

Test script or set of commands reproducing this issue

NA

Environment

github source

[AutomatedTester]

The decision was to simplify the APIs across the languages and this does that. The docstring was missed and now been corrected.

[bonafideduck]

Well if simplifying the APIs allows this quick of a fix time, I can live with the change 🎃