DOC: tweak example + add some extra prose

tacaswell · tacaswell · commit 68230b21ecb9 · 2017-01-16T13:16:13.000-05:00
diff --git a/doc/users/whats_new/imshow_logscales.rst b/doc/users/whats_new/imshow_logscales.rst
@@ -22,7 +22,7 @@ Example
 
     fig, (ax1, ax2) = plt.subplots(ncols=2, figsize=(8, 4))
 
-    ax1.imshow(data, aspect="auto", extent=(0, 5, 1e0, 1e5), interpolation='nearest')
+    ax1.imshow(data, aspect="auto", extent=(0, 6, 1e0, 1e5), interpolation='nearest')
     ax1.set_yscale('log')
     ax1.set_title('Using ax.imshow')
 
@@ -33,3 +33,7 @@ Example
 
     plt.show()
 
+
+This can be understood by analogy to plotting a histogram with linearly spaced bins
+with a logarithmic x-axis.  Equal sized bins at will be displayed as wider for small
+*x* and narrower for large *x*.
