Fix docstring issues
I think I will stop pushing to this PR, so that it can me merged for today release. 

I will open another PR for further fixing docs.

Do you agree, @lhoestq ? Sounds good thanks !
Fix docstring issues.