DOC: Adding a release note for the Colorbar behavior change

greglucas · greglucas · commit bf833a8d55be · 2021-06-02T07:21:42.000-06:00
diff --git a/doc/api/next_api_changes/behavior/20XXX-GL.rst b/doc/api/next_api_changes/behavior/20XXX-GL.rst
@@ -0,0 +1,16 @@
+Colorbars are now an instance of Axes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The :class:`.colorbar.Colorbar` class now inherits from `.axes.Axes`,
+meaning that all of the standard methods of ``Axes`` can be used
+directly on the colorbar object itself rather than having to access the
+``ax`` attribute. For example, ::
+
+    cbar.set_yticks()
+
+rather than ::
+
+    cbar.ax.set_yticks()
+
+We are leaving the ``cbar.ax`` attribute in place as a pass-through for now,
+which just maps back to the colorbar object.
