DOC: v0.15.0 for GH8226

Author: jreback

doc/source/v0.15.0.txt

@@ -19,7 +19,7 @@ users upgrade to this version.
   - Internal refactoring of the ``Index`` class to no longer sub-class ``ndarray``, see :ref:`Internal Refactoring <whatsnew_0150.refactoring>`
   - New datetimelike properties accessor ``.dt`` for Series, see :ref:`Datetimelike Properties <whatsnew_0150.dt>`
   - dropping support for ``PyTables`` less than version 3.0.0, and ``numexpr`` less than version 2.1 (:issue:`7990`)
-  - API change in using Indexs set operations, see :ref:`here <whatsnew_0150.index_set_ops>`
+  - API change in using Indexes in set operations, see :ref:`here <whatsnew_0150.index_set_ops>`
 
 - :ref:`Other Enhancements <whatsnew_0150.enhancements>`
 
@@ -347,7 +347,23 @@ API changes
 
 .. _whatsnew_0150.index_set_ops:
 
-- The Index set operations ``+`` and ``-`` were deprecated in order to provide these for numeric type operations on certain index types. ``+`` can be replace by ``.union()`` or ``|``, and ``-`` by ``.difference()``. Further the method name ``Index.diff()`` is deprecated and can be replaced by ``Index.difference()``
+- The Index set operations ``+`` and ``-`` were deprecated in order to provide these for numeric type operations on certain index types. ``+`` can be replace by ``.union()`` or ``|``, and ``-`` by ``.difference()``. Further the method name ``Index.diff()`` is deprecated and can be replaced by ``Index.difference()`` (:issue:`8226`)
+
+.. code-block:: python
+
+   # +
+   Index(['a','b','c']) + Index(['b','c','d'])
+
+   # should be replaced by
+   Index(['a','b','c']).union(Index(['b','c','d']))
+
+.. code-block:: python
+
+   # -
+   Index(['a','b','c']) - Index(['b','c','d'])
+
+   # should be replaced by
+   Index(['a','b','c']).difference(Index(['b','c','d']))
 
 .. _whatsnew_0150.dt: