One thing I sometimes find confusing about docstrings in certain packages is that keyword arguments are not listed and I have to dig through the code to find them. Even some documentation pages lack these descriptions. I don’t have an example in mind at the moment.