DOC: copied over the shared transform documentation from Series/DataF…
…rame.transform to core.GroupBy.transform. (#6257)

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