Apply suggestions from code review

Co-authored-by: Jody Klymak <[email protected]>

Author: rwpenney

doc/users/next_whats_new/asinh_scale.rst

@@ -1,5 +1,5 @@
-New axis scale ``asinh``
-------------------------
+New axis scale ``asinh`` (experimental)
+---------------------------------------
 
 The new ``asinh`` axis scale offers an alternative to ``symlog`` that
 smoothly transitions between the quasi-linear and asymptotically logarithmic

examples/images_contours_and_fields/colormap_normalizations_symlognorm.py

@@ -56,7 +56,7 @@ def rbf(x, y):
 # In order to find the best visualization for any particular dataset,
 # it may be necessary to experiment with multiple different color scales.
 # As well as the `~.colors.SymLogNorm` scaling, there is also
-# the option of using the `~.colors.AsinhNorm`, which has a smoother
+# the option of using `~.colors.AsinhNorm` (experimental), which has a smoother
 # transition between the linear and logarithmic regions of the transformation
 # applied to the data values, "Z".
 # In the plots below, it may be possible to see contour-like artifacts

examples/scales/asinh_demo.py

@@ -34,6 +34,8 @@
 and reduces visual artifacts associated with an abrupt
 transition between linear and logarithmic regions of the plot.
 
+.. note::
+   `.scale.AsinhScale` is experimental, and the API may change.
 See `~.scale.AsinhScale`, `~.scale.SymmetricalLogScale`.
 """