I used it a month or two ago, so I don't remember specifics, but. The docs weren't unclear, they were bare compared to pandas tough. Once I found an example of how to do something I managed to do it. But a couple of times I opened a page and there was WIP message.
There's definitely a bit of unfairness in the comparison, as pandas as you say has been the standard for python for years. But that means I already know all the syntax and how the API works, so even just a method name or required params will get me a long way.
When I was fumbling around with polars I would have liked more examples of how to use each method/function. I mean, once the language clicks I wouldn't need it anymore. But at the start I really need that hand-holding. I'd have to reread other pages to remember simple syntax.