@mdboom's suggested devel documentation for boilerplate.

pelson · pelson · commit 46e1761e92e8 · 2012-06-11T13:52:52.000+01:00
diff --git a/doc/devel/coding_guide.rst b/doc/devel/coding_guide.rst
@@ -351,14 +351,12 @@ object::
 
 Writing a new pyplot function
 =============================
-
-The :mod:`matplotlib.pyplot` module can be thought of as combination of some
-manually written and some autogenerated functions. Modifications can be made
-to pyplot where the function definition does not explicitly state otherwise
-and autogenerated functions can be modified by changing, and subsequently 
-runnning, the :file:`boilerplate.py` script which will re-generate the complete
-pyplot module inplace, keeping all of the manual content.
-
+A large portion of the pyplot interface is automatically generated by the 
+`boilerplate.py` script (in the root of the source tree).  To add or remove
+a plotting method from pyplot, edit the appropriate list in `boilerplate.py`
+and then run the script which will update the content in 
+`lib/matplotlib/pyplot.py`. Both the changes in `boilerplate.py` and 
+`lib/matplotlib/pyplot.py` should be checked into the repository.
 
 Testing
 =======
