DOC: correct merge_asof example
- [ ] closes #19489 
- [x] tests added / passed
- [ ] passes `git diff upstream/master -u -- "*.py" | flake8 --diff`
- [ ] whatsnew entry

- update of incorrect documentation example for merge_asof.
- add a test corresponding to this example.