diff --git a/Doc/source/pens/index.rst b/Doc/source/pens/index.rst
index 0caa286b6..e26d6d5b2 100644
--- a/Doc/source/pens/index.rst
+++ b/Doc/source/pens/index.rst
@@ -12,14 +12,14 @@ Some pens trace through the outlines and generate graphical output,
 such as a new glyph outline or a formatted image, but other
 pens analyze the outlines and return information about the glyph.
 
-Pens that alter or produce a pen-compatile ``ttGlyph`` object can
+Pens that alter or produce a pen-compatible :class:`.ttGlyph` object can
 be chained together.
 
-New pens can be written by subclassing the ``AbstractPen`` or,
-somewhat more practically, ``BasePen`` classes. The Pen Protocol is
-documented on the ``BasePen`` page.
+New pens can be written by sub-classing the :class:`.AbstractPen` or,
+somewhat more practically, :class:`.BasePen` classes. The Pen Protocol is
+documented on the :ref:`basePen` page.
 
-.. rubric:: Pens:
+.. rubric:: Pen modules:
    :heading-level: 3
 
 .. toctree::