DOC: Updated the docstring of Series.rank / DataFrame.rank
- [X] passes `git diff upstream/master -u -- "*.py" | flake8 --diff`

I have updated the docstring following the convention and I have added some examples.

Please let me know if I can further improve this.

Thanks