I am 👍🏻 on the docs (left one suggestion), but am 50/50 on the API change. On one hand snake_case 👍🏻 , on the other hand I suspect people have found this (e.g.https://stackoverflow.com/search?tab=votes&q=%5bmatplotlib%5d%20legendHandles) and we should err on not breaking people over aesthetics 👎🏻 .

@tacaswell I'm sure you've seen#20639 (comment) so I ping@timhoffm Personally, I do not have strong opinions on the naming.

Edit: one way to obtain both is to leavelegendHandles pointing tolegend_handles, but only documentlegend_handles?

Edit: one way to obtain both is to leavelegendHandles pointing tolegend_handles, but only documentlegend_handles?

Yes, that's the reasonable thing to do. I checkedhttps://github.com/search?l=Python&p=5&q=legendHandles&type=Code and it seems thatlegendHandles is widely used.

That way we pomote a clean API but don't break existing code. The maintainance cost for the alias is negligible.

I took the liberty of accepting the suggestions and normalizing the comment.@oscargus Can you merge this if you are happy with the changes?

and rebased + fixed the conflicting changes on main.