From user feedback, there are two admonitions we should update:

• click(selector) - we have a warning at the top that says to use locator(click) instead, but doesn't explain why.
• locator(click) - we have a caution that the method has known issues and include links, but we don't explain why as well.

We should update these admonitions to give more details to the user what we recommend and why, and any possible drawbacks.

This could also be a new best practices guide.