lsst · jonathansick · Jul 13, 2018 · Jul 12, 2018 · Jul 12, 2018 · Jul 12, 2018
diff --git a/doc/FITS headers for exposures.rst b/doc/FITS headers for exposures.rst
diff --git a/doc/Makefile b/doc/Makefile
diff --git a/doc/detection/index.rst b/doc/detection/index.rst
diff --git a/doc/index.rst b/doc/index.rst
@@ -20,5 +20,3 @@ afw documentation preview
    lsst.afw.image/index
    lsst.afw.math/index
    lsst.afw.table/index
-   detection/index
-   FITS headers for exposures.rst
diff --git a/doc/detection/Footprint.rst → doc/lsst.afw.detection/Footprint.rst b/doc/detection/Footprint.rst → doc/lsst.afw.detection/Footprint.rst
@@ -1,6 +1,6 @@
-#########
-Footprint
-#########
+###############################################################
+Using lsst.afw.detection.Footprint to represent detection areas
+###############################################################
 
 The fundamental unit of a detection in the LSST pipeline is an instance of the
 ``Footprint`` class. This class contains the x, y locations for pixels that are

diff --git a/doc/lsst.afw.detection/index.rst b/doc/lsst.afw.detection/index.rst
@@ -6,7 +6,15 @@ lsst.afw.detection
 
 .. Paragraph that describes what this Python module does and links to related modules and frameworks.
 
-.. Add subsections with toctree to individual topic pages.
+.. _lsst.afw.detection-using:
+
+Using lsst.afw.detection
+========================
+
+.. toctree::
+   :maxdepth: 1
+
+   Footprint
 
 Python API reference
 ====================

diff --git a/doc/lsst.afw.geom/SpanSet.rst b/doc/lsst.afw.geom/SpanSet.rst
@@ -1,6 +1,6 @@
-#######
-SpanSet
-#######
+####################################################################
+Using lsst.afw.geom.SpanSet to represent irregular regions of pixels
+####################################################################
 
 A ``SpanSet`` is a class that represents regions of pixels on an image.  As the
 name implies, a ``SpanSet`` is a collection of ``Span`` objects which behave as

diff --git a/doc/lsst.afw.geom/index.rst b/doc/lsst.afw.geom/index.rst
@@ -20,5 +20,8 @@ Python API reference
 ====================
 
 .. automodapi:: lsst.afw.geom
-   :skip: SinglePolygonException
+   :no-main-docstr:
+   :skip: SinglePolygonException, all, any, arcsecToRad, averageSpherePoint, ceil, degToRad, floor, isAngle, makeAffineTransformFromTriple, masToRad, radToArcsec, radToDeg, radToMas, truncate, AffineTransform, Angle, AngleUnit, Box2I, BoxD, BoxI, Box2D, CoordinateBaseCoordinateExpr2, CoordinateBaseCoordinateExpr3, CoordinateBaseExtent2D, CoordinateBaseExtent2I, CoordinateBaseExtent3D, CoordinateBaseExtent3I, CoordinateBasePoint2D, CoordinateBasePoint2I, CoordinateBasePoint3D, CoordinateBasePoint3I, CoordinateExpr, CoordinateExpr2, CoordinateExpr3, Extent, Extent2D, Extent2I, Extent3D, Extent3I, ExtentBase2D, ExtentBase2I, ExtentBase3D, ExtentBase3I, ExtentD, ExtentI, LinearTransform, Point, Point2D, Point2I, Point3D, Point3I, PointBase2D, PointBase2I, PointBase3D, PointBase3I, PointD, PointI, SpherePoint
+
 .. automodapi:: lsst.afw.geom.testUtils
+   :no-main-docstr: