add docs

Author: jreback

pandas/core/groupby/base.py

@@ -1,5 +1,7 @@
 """
-base components for groupby
+Provide basic components for groupby. These defintiions
+hold the whitelist of methods that are exposed on the
+SeriesGroupBy and the DataFrameGroupBy objects.
 """
 
 import types

pandas/core/groupby/generic.py

@@ -1,6 +1,7 @@
 """
 Define the SeriesGroupBy, DataFrameGroupBy, and PanelGroupBy
 classes that hold the groupby interfaces (and some implementations).
+
 These are user facing as the result of the ``df.groupby(...)`` operations,
 which here returns a DataFrameGroupBy object.
 """

pandas/core/groupby/groupby.py

@@ -1,3 +1,12 @@
+"""
+Provide the groupby split-apply-combine paradigm. Define the GroupBy
+class providing the base-class of operations.
+
+The SeriesGroupBy and DataFrameGroupBy sub-class
+(defined in pandas.core.groupby.generic)
+expose these user-facing objects to provide specific functionailty.
+"""
+
 import types
 from functools import wraps, partial
 import datetime

pandas/core/groupby/ops.py

@@ -1,7 +1,9 @@
 """
-Perform the groupby aggregate operations. These are not exposed
-to the user and provide implementations of the grouping
-operations. These are generally called via the *GroupBy objects.
+Provide classe to perform the groupby aggregate operations.
+
+These are not exposed to the user and provide implementations of the grouping
+operations, primarily in cython. These classes (BaseGrouper and BinGrouper)
+are contained *in* the SeriesGroupBy and DataFrameGroupBy objects.
 """
 
 import copy