Documentation Link

https://matplotlib.org/stable/api/_as_gen/matplotlib.pyplot.draw.html

Problem

This is equivalent to calling fig.canvas.draw_idle(), where fig is the current figure.

To me, draw sounds a synchronous behavior, whereas draw_idle sounds like an asynchronous behavior. I think this statement of equivalence is confusing, because it claims what sounds to me like two different behaviors, are actually the same.

Can we elaborate on the equivalence, perhaps making it more clear what draw_idle means?

Also, on that page, can we link to the docs for draw_idle (if there are docs on it)?

Suggested improvement

I am not familiar with matplotlib enough to make a quality suggestion here.