DOC: Rearrange the polynomial documents.

This is the first step in cleaning up the polynomial documentation
and writing an instructional section on the convenience classes.

1 files changed, 15 insertions, 0 deletions

diff --git a/doc/source/reference/routines.polynomials.classes.rst b/doc/source/reference/routines.polynomials.classes.rst
new file mode 100644
index 000000000..803251fbf
--- /dev/null
+++ b/doc/source/reference/routines.polynomials.classes.rst
@@ -0,0 +1,15 @@
+Using the Convenience Classes
+=============================
+
+The classes in the polynomial package can be imported directly from
+numpy.polynomial as well as from the corresponding modules.::
+
+    >>> from numpy.polynomial import Polynomial as P
+    >>> p = P([0, 0, 1])
+    >>> p**2
+    Polynomial([ 0.,  0.,  0.,  0.,  1.], [-1.,  1.], [-1.,  1.])
+
+Because most of the functionality in the modules of the polynomial package
+is available through the corresponding classes, including fitting, shifting
+and scaling, and conversion between classes, it should not be necessary to
+use the functions in the modules except for multi-dimensional work.