We don't have docstrings with `:param:` anywhere else. I don't think that we should add it just for this function. Anyway, I will add an example to the module documentation as it's everywhere else.