DOC: Improve the docstring of String.str.zfill()
- [ ] closes #xxxx
- [ ] tests added / passed
- [x] passes `git diff upstream/master -u -- "*.py" | flake8 --diff`
- [ ] whatsnew entry

Result of the Pandas sprint at PyData London 2018. Includes work by @owlas.