4 files changed, 33 insertions, 3 deletions
diff --git a/doc/source/reference/routines.poly.rst b/doc/source/reference/routines.polynomials.poly1d.rst
index f30b2c884..7eef53ce2 100644
--- a/doc/source/reference/routines.poly.rst
+++ b/doc/source/reference/routines.polynomials.poly1d.rst
@@ -1,5 +1,5 @@
-Polynomials
-***********
+Poly1d
+======
 
 .. currentmodule:: numpy
 
diff --git a/doc/source/reference/routines.polynomials.polynomial.rst b/doc/source/reference/routines.polynomials.polynomial.rst
new file mode 100644
index 000000000..aa92ce8fc
--- /dev/null
+++ b/doc/source/reference/routines.polynomials.polynomial.rst
@@ -0,0 +1,16 @@
+Polynomial Package (:mod:`numpy.polynomial`)
+============================================
+
+.. currentmodule:: numpy.polynomial
+
+Polynomial Classes
+------------------
+.. autosummary::
+   :toctree: generated/
+
+   Polynomial
+   Chebyshev
+   Legendre
+   Hermite
+   HermiteE
+   Laguerre
diff --git a/doc/source/reference/routines.polynomials.rst b/doc/source/reference/routines.polynomials.rst
new file mode 100644
index 000000000..59d6bc499
--- /dev/null
+++ b/doc/source/reference/routines.polynomials.rst
@@ -0,0 +1,14 @@
+Polynomials
+***********
+
+The poly1d functions are considered outdated but are retained for
+backward compatibility. New software needing polynomials should
+use the classes in the Polynomial Package.
+
+.. toctree::
+   :maxdepth: 2
+
+   routines.polynomials.polynomial
+   routines.polynomials.poly1d
+
+
diff --git a/doc/source/reference/routines.rst b/doc/source/reference/routines.rst
index c97a3d244..fb53aac3b 100644
--- a/doc/source/reference/routines.rst
+++ b/doc/source/reference/routines.rst
@@ -29,7 +29,7 @@ indentation.
    routines.statistics
    routines.math
    routines.functional
-   routines.poly
+   routines.polynomials
    routines.datetime
    routines.financial
    routines.set