Minor docs cleanup

Author: lukelbd

HOWTOCONTRIBUTE.rst

@@ -40,11 +40,11 @@ Write tests
 
 Most modern python packages have ``test_*.py`` scripts that are run by `pytest`
 via the `Travis Continuous Integration <https://travis-ci.com>`__ service
-whenever commits are pushed to the repository. Currently, proplot only tests
-the examples that appear on the website User Guide (see `.travis.yml`). While we
-try to make the examples comprehensive, this approach leaves out a lot of use
-cases and leaves the project more vulnerable to bugs. Adding tests is a
-*critical* item on our to-do list.
+whenever commits are pushed to the repository. Currently, automatic testing only
+includes the examples that appear on the website User Guide (see `.travis.yml`),
+and `Luke Davis <https://github.com/lukelbd>` runs additional tests manually on
+his machine. This approach leaves out many use cases and leaves the project more
+vulnerable to bugs. Adding tests is a *critical* item on our to-do list.
 
 If you can think of a useful test for proplot, feel free to submit a pull request.
 Your test will be used in the future.

docs/colorbars_legends.py

@@ -31,10 +31,10 @@
 # Outer and inset locations
 # -------------------------
 #
-# Matplotlib supports drawing "inset" legends and "outer" colorbars using
-# the `loc` and `location` keyword arguments. However, "outer" legends are
-# only posssible using the somewhat counterintuitive `bbox_to_anchor` keyword
-# (see `this stackoverflow post <https://stackoverflow.com/q/4700614/4970632>`__)
+# Matplotlib supports drawing "inset" legends and "outer" colorbars using the `loc`
+# and `location` keyword arguments. However, "outer" legends are only posssible using
+# the somewhat counterintuitive `bbox_to_anchor` keyword (see `here
+# <https://matplotlib.org/stable/tutorials/intermediate/legend_guide.html#legend-location>`__)
 # and "inset" colorbars are not possible without manually creating and positioning
 # the associated axes. Proplot tries to improve this behavior:
 #
@@ -54,6 +54,7 @@
 #   (e.g., ``loc='upper right'`` or the shorthand ``loc='ur'``). Inset
 #   colorbars have optional background "frames" that can be configured
 #   with various `~proplot.axes.Axes.colorbar` keywords.
+# * Outer colorbars and legends can be aligned using the `align` keyword.
 
 # `~proplot.axes.Axes.colorbar` and `~proplot.axes.Axes.legend` also both accept
 # `space` and `pad` keywords. `space` controls the absolute separation of the
@@ -139,13 +140,13 @@
 data = (state.rand(30, 10) - 0.5).cumsum(axis=0)
 ax = fig.subplot(121, title='On-the-fly legend')
 ax.plot(  # add all at once
-    data[:, :5], lw=2, cycle='Blues1', cycle_kw={'ls': ('-', '--'), 'left': 0.1},
-    labels=labels, legend='l', legend_kw={'frame': False, 'ncols': 1}
+    data[:, :5], lw=2, cycle='Reds1', cycle_kw={'ls': ('-', '--'), 'left': 0.1},
+    labels=labels, legend='b', legend_kw={'title': 'legend title'}
 )
 for i in range(5):
     ax.plot(  # add one-by-one
-        data[:, 5 + i], lw=2, cycle='Reds1', cycle_kw={'ls': ('-', '--'), 'left': 0.1},
-        label=labels[i], legend='b', legend_kw={'title': 'legend title'},
+        data[:, 5 + i], label=labels[i], linewidth=2,
+        cycle='Blues1', cycle_kw={'N': 5, 'ls': ('-', '--'), 'left': 0.1},
         colorbar='ul', colorbar_kw={'label': 'colorbar from lines'}
     )
 
@@ -157,9 +158,8 @@
     colorbar_kw={'length': 0.8, 'label': 'colorbar label'},
 )
 ax.contour(
-    data, cmap='Mono_r', cmap_kw={'left': 0.05}, lw=1.5,
-    colorbar='r', colorbar_kw={'label': 'colorbar label', 'length': 0.7},
-    label='contour', legend='ul', legend_kw={'label': 'legend from mappable'},
+    data, color='gray7', lw=1.5,
+    label='contour', legend='ul', legend_kw={'label': 'legend from contours'},
 )
 
 # %%