Improve docstring for zfill
 - Added more information for zfill
 - Document differences between pandas and standard library zfill

- [ ] closes #xxxx
- [x] tests added / passed
- [x] passes `git diff upstream/master -u -- "*.py" | flake8 --diff`
- [ ] whatsnew entry

See #20864