DOC: Fix documentation for DataFrame.groupby.transform

[vladu]

• The doc template should no longer reference "Series" transforms explicitly.
• Make consistent the formatting for references to function argument names.

[jreback]

looks fine. @rhshadrach if any comments.

[rhshadrach]

Thanks for the PR! Looks to be in good shape, just one request below.

[rhshadrach]

I would think that this should be about DataFrame.groupby.transform, rather than DataFrame.transform.

[vladu]

So this is the doc string for DataFrame.groupby.transform. So in the "See Also" section, it makes sense to me that it references the ungrouped DataFrame.transform.

[rhshadrach]

Ahh, whoops, thanks! In that case, may want to specify that transform operates on the columns rather than self.

[vladu]

Sorry, let me be more specific. This is a template doc-string that is reused for both [DataFrame|Series].groupby.transform. Hence the "klass" templating. In master right now, the "see also" section specifically talks about Series, which doesn't make sense for DataFrame. So my PR here is to fix that. The text I inserted, is taken verbatim from the template for [DataFrame|Series].tansform. I think that's the reason it's being a little vague, and avoiding verbiage that would imply dimensionality.

[rhshadrach]

Thanks - make sense. It does seem to me desirable to improve this (namely, it seems to me to be misleading in the DataFrame case), but okay for this PR.

[rhshadrach]

Thanks @vladu!

[vladu]

Thanks, Richard. I appreciate your feedback. This was my first PR to pandas, and I was trying to do something low impact / low controversy. Will be more comprehensive going forward.

-- Vlad

[rhshadrach]

@vladu - I wouldn't recommend changing a thing. To make sure - my complaint about the current docs for DataFrame.transform was very much outside the scope of this PR. This was well done.