From fba0737f2b55f9ea50c14888b2a16ed391270262 Mon Sep 17 00:00:00 2001
From: Mitch Negus <21086604+mitchnegus@users.noreply.github.com>
Date: Thu, 1 Feb 2018 05:15:42 -0800
Subject: [PATCH] updated hist documentation (#19366)

---
 pandas/plotting/_core.py | 23 ++++++++++++++++++-----
 1 file changed, 18 insertions(+), 5 deletions(-)

diff --git a/pandas/plotting/_core.py b/pandas/plotting/_core.py
index 8b03d6ddde4ec..88b899ad60313 100644
--- a/pandas/plotting/_core.py
+++ b/pandas/plotting/_core.py
@@ -2156,10 +2156,18 @@ def hist_frame(data, column=None, by=None, grid=True, xlabelsize=None,
         The size of the figure to create in inches by default
     layout : tuple, optional
         Tuple of (rows, columns) for the layout of the histograms
-    bins : integer, default 10
-        Number of histogram bins to be used
+    bins : integer or sequence, default 10
+        Number of histogram bins to be used. If an integer is given, bins + 1
+        bin edges are calculated and returned. If bins is a sequence, gives
+        bin edges, including left edge of first bin and right edge of last
+        bin. In this case, bins is returned unmodified.
     `**kwds` : other plotting keyword arguments
         To be passed to hist function
+
+    See Also
+    --------
+    matplotlib.axes.Axes.hist : Plot a histogram using matplotlib.
+
     """
     _converter._WARN = False
     if by is not None:
@@ -2219,14 +2227,19 @@ def hist_series(self, by=None, ax=None, grid=True, xlabelsize=None,
         rotation of y axis labels
     figsize : tuple, default None
         figure size in inches by default
+    bins : integer or sequence, default 10
+        Number of histogram bins to be used. If an integer is given, bins + 1
+        bin edges are calculated and returned. If bins is a sequence, gives
+        bin edges, including left edge of first bin and right edge of last
+        bin. In this case, bins is returned unmodified.
     bins: integer, default 10
         Number of histogram bins to be used
     `**kwds` : keywords
         To be passed to the actual plotting function
 
-    Notes
-    -----
-    See matplotlib documentation online for more on this
+    See Also
+    --------
+    matplotlib.axes.Axes.hist : Plot a histogram using matplotlib.
 
     """
     import matplotlib.pyplot as plt