3 files changed, 7 insertions, 19 deletions

diff --git a/doc/source/reference/arrays.classes.rst b/doc/source/reference/arrays.classes.rst
index 41253a077..f5a262076 100644
--- a/doc/source/reference/arrays.classes.rst
+++ b/doc/source/reference/arrays.classes.rst
@@ -263,24 +263,6 @@ Masked arrays (:mod:`numpy.ma`)
 
 .. seealso:: :ref:`maskedarray`
 
-Masked arrays are arrays that may have missing or invalid entries.
-The :mod:`numpy.ma` module provides a nearly work-alike replacement for numpy
-that supports data arrays with masks.
-
-
-.. XXX: masked array documentation should be improved
-
-.. currentmodule:: numpy
-
-.. index::
-   single: masked arrays
-
-.. toctree::
-   :maxdepth: 2
-
-   maskedarray
-
-
 Standard container class
 ========================
 
diff --git a/doc/source/reference/arrays.rst b/doc/source/reference/arrays.rst
index b6d28fe2c..4204f13a4 100644
--- a/doc/source/reference/arrays.rst
+++ b/doc/source/reference/arrays.rst
@@ -43,4 +43,5 @@ of also more complicated arrangements of data.
    arrays.dtypes
    arrays.indexing
    arrays.classes
+   maskedarray
    arrays.interface
diff --git a/doc/source/reference/maskedarray.rst b/doc/source/reference/maskedarray.rst
index aae06c361..c2deb3ba1 100644
--- a/doc/source/reference/maskedarray.rst
+++ b/doc/source/reference/maskedarray.rst
@@ -1,14 +1,19 @@
 .. _maskedarray:
 
+*************
+Masked arrays
+*************
 
 Masked arrays are arrays that may have missing or invalid entries.
 The :mod:`numpy.ma` module provides a nearly work-alike replacement for numpy
 that supports data arrays with masks.
 
+.. index::
+   single: masked arrays
 
 .. toctree::
    :maxdepth: 2
 
    maskedarray.generic
    maskedarray.baseclass
-   routines.ma
\ No newline at end of file
+   routines.ma