Fix doc blocks
minor #10740 [2.5] Fix doc blocks (romainneutron)

This PR was merged into the 2.5-dev branch.

Discussion
----------

[2.5] Fix doc blocks

| Q             | A
| ------------- | ---
| Bug fix?      | no
| New feature?  | no
| BC breaks?    | no
| Deprecations? | no
| Tests pass?   | yes
| Fixed tickets | n/a
| License       | MIT

Last one on this topic, in master branch. This follows #10738 and #10737

Commits
-------

90294ec Fix doc blocks