DOC/API: pd.Grouper docs / api

address comments from #6516

docs and api