DOC: Added examples for union_categoricals
 - [x] closes #16390 
 - [ ] tests added / passed
 - [x] passes ``git diff upstream/master --name-only -- '*.py' | flake8 --diff``
 - [ ] whatsnew entry

Copied and posted over examples into the doc string; added link.