DOC: Capitalize docstring summaries

pandas/core/frame.py

@@ -1953,7 +1953,7 @@ def to_stata(self, fname, convert_dates=None, write_index=True,
 
  def to_feather(self, fname):
  """
- write out the binary feather-format for DataFrames
+ Write out the binary feather-format for DataFrames.
 
  .. versionadded:: 0.20.0
 
@@ -5839,7 +5839,7 @@ def unstack(self, level=-1, fill_value=None):
  return unstack(self, level, fill_value)
 
  _shared_docs['melt'] = ("""
- "Unpivots" a DataFrame from wide format to long format, optionally
+ 'Unpivots' a DataFrame from wide format to long format, optionally
  leaving identifier variables set.
 
  This function is useful to massage a DataFrame into a format where one
@@ -6045,7 +6045,7 @@ def _gotitem(self,
  ):
  # type: (...) -> Union[Series, DataFrame]
  """
- sub-classes to define
+ Sub-classes to define
  return a sliced object
 
  Parameters

pandas/core/groupby/base.py

@@ -12,11 +12,11 @@
 
 
 class GroupByMixin(object):
- """ provide the groupby facilities to the mixed object """
+ """ Provide the groupby facilities to the mixed object. """
 
  @staticmethod
  def _dispatch(name, *args, **kwargs):
- """ dispatch to apply """
+ """ Dispatch to apply. """
 
  def outer(self, *args, **kwargs):
  def f(x):
@@ -28,8 +28,8 @@ def f(x):
 
  def _gotitem(self, key, ndim, subset=None):
  """
- sub-classes to define
- return a sliced object
+ Sub-classes to define
+ return a sliced object.
 
  Parameters
  ----------

pandas/core/groupby/groupby.py

@@ -291,7 +291,7 @@ class providing the base-class of operations.
 
 class GroupByPlot(PandasObject):
  """
- Class implementing the .plot attribute for groupby objects
+ Class implementing the .plot attribute for groupby objects.
  """
 
  def __init__(self, groupby):
@@ -314,7 +314,7 @@ def f(self):
 @contextmanager
 def _group_selection_context(groupby):
  """
- set / reset the _group_selection_context
+ Set / reset the _group_selection_context.
  """
  groupby._set_group_selection()
  yield groupby
@@ -377,14 +377,14 @@ def __unicode__(self):
 
  def _assure_grouper(self):
  """
- we create the grouper on instantiation
- sub-classes may have a different policy
+ We create the grouper on instantiation
+ sub-classes may have a different policy.
  """
  pass
 
  @property
  def groups(self):
- """ dict {group name -> group labels} """
+ """ Dict {group name -> group labels} """
  self._assure_grouper()
  return self.grouper.groups
 
@@ -395,14 +395,14 @@ def ngroups(self):
 
  @property
  def indices(self):
- """ dict {group name -> group indices} """
+ """ Dict {group name -> group indices} """
  self._assure_grouper()
  return self.grouper.indices
 
  def _get_indices(self, names):
  """
- safe get multiple indices, translate keys for
- datelike to underlying repr
+ Safe get multiple indices, translate keys for
+ datelike to underlying repr.
  """
 
  def get_converter(s):
@@ -450,7 +450,7 @@ def get_converter(s):
  return [self.indices.get(name, []) for name in names]
 
  def _get_index(self, name):
- """ safe get index, translate keys for datelike to underlying repr """
+ """ Safe get index, translate keys for datelike to underlying repr ."""
  return self._get_indices([name])[0]
 
  @cache_readonly
@@ -1127,7 +1127,7 @@ def mean(self, *args, **kwargs):
  @Appender(_doc_template)
  def median(self, **kwargs):
  """
- Compute median of groups, excluding missing values
+ Compute median of groups, excluding missing values.
 
  For multiple groupings, the result index will be a MultiIndex
  """
@@ -1148,9 +1148,9 @@ def f(x):
  @Appender(_doc_template)
  def std(self, ddof=1, *args, **kwargs):
  """
- Compute standard deviation of groups, excluding missing values
+ Compute standard deviation of groups, excluding missing values.
 
- For multiple groupings, the result index will be a MultiIndex
+ For multiple groupings, the result index will be a MultiIndex.
 
  Parameters
  ----------
@@ -1166,9 +1166,9 @@ def std(self, ddof=1, *args, **kwargs):
  @Appender(_doc_template)
  def var(self, ddof=1, *args, **kwargs):
  """
- Compute variance of groups, excluding missing values
+ Compute variance of groups, excluding missing values.
 
- For multiple groupings, the result index will be a MultiIndex
+ For multiple groupings, the result index will be a MultiIndex.
 
  Parameters
  ----------
@@ -1192,9 +1192,9 @@ def var(self, ddof=1, *args, **kwargs):
  @Appender(_doc_template)
  def sem(self, ddof=1):
  """
- Compute standard error of the mean of groups, excluding missing values
+ Compute standard error of the mean of groups, excluding missing values.
 
- For multiple groupings, the result index will be a MultiIndex
+ For multiple groupings, the result index will be a MultiIndex.
 
  Parameters
  ----------