DOC GH17505 Added some links and examples. To little/much/wrong?
- [ ] closes #17505 
- [ ] tests added / passed
- [ ] passes `git diff upstream/master -u -- "*.py" | flake8 --diff`
- [ ] whatsnew entry

Before I spend more time on this, I'd like to know if I am doing to much, to little or just plain all wrong.
