From fe8cc13f9bff1e8d57ed991d67b09e8556edf23c Mon Sep 17 00:00:00 2001
From: Tom Augspurger <tom.w.augspurger@gmail.com>
Date: Sat, 5 Dec 2015 08:06:02 -0600
Subject: [PATCH] DOC: Explain `Styler.set_table_styles`

Also included an example.
---
 pandas/core/style.py | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/pandas/core/style.py b/pandas/core/style.py
index 5974e0e660a0b..59bf6118a79c6 100644
--- a/pandas/core/style.py
+++ b/pandas/core/style.py
@@ -520,17 +520,31 @@ def set_caption(self, caption):
 
     def set_table_styles(self, table_styles):
         """
-        Set the table styles on a Styler
+        Set the table styles on a Styler. These are placed in a
+        ``<style>`` tag before the generated HTML table.
 
         .. versionadded:: 0.17.1
 
         Parameters
         ----------
         table_styles: list
+            Each individual table_style should be a dictionary with
+            ``selector`` and ``props`` keys. ``selector`` should be a CSS
+            selector that the style will be applied to (automatically
+            prefixed by the table's UUID) and ``props`` should be a list of
+            tuples with ``(attribute, value)``.
 
         Returns
         -------
         self
+
+        Examples
+        --------
+        >>> df = pd.DataFrame(np.random.randn(10, 4))
+        >>> df.style.set_table_styles(
+        ...     [{'selector': 'tr:hover',
+        ...       'props': [('background-color', 'yellow')]}]
+        ... )
         """
         self.table_styles = table_styles
         return self