docs(python): fix bad bullet points

[MarcoGorelli]

Here's a mistake I keep making: writing bullet points in docstrings in a way that won't render

It seems like a common mistake - running this little script I put together, I found the following two cases where the docstring doesn't render as expected:

• https://pola-rs.github.io/polars/py-polars/html/reference/expressions/api/polars.from_epoch.html
• https://pola-rs.github.io/polars/py-polars/html/reference/api/polars.scan_delta.html#polars-scan-delta

I couldn't find an existing tool which does this, so put together a little script

---

Original motivation: #10235 (comment)

[Fokko]

Love it!

[ritchie46]

@stinodego I'd like to leave this one to you.

[stinodego]

I'm not a big fan of custom linting scripts like this. If you do this for every issue you run into, you'll have 100 linting scripts by the end of it.

This did trigger me to take another look at our Sphinx setup, and I've included the docstring fixes in #10400.

I'd say for now let's just pay some extra attention to make sure we don't merge broken docstring RST formatting. Meanwhile, I'm looking into parsing the docstrings as Markdown as a proper solution...

Closing this for now, though discussion is welcome.

[MarcoGorelli]

Sure, no worries, thanks!