diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml
index 71e74e869b..d0dc0b0900 100644
--- a/documentation/ref-manual/ref-classes.xml
+++ b/documentation/ref-manual/ref-classes.xml
@@ -133,18 +133,23 @@
 </section>
 
 <section id='ref-classes-base'>
-    <title>The base Class - <filename>base.bbclass</filename></title>
+    <title><filename>base.bbclass</filename></title>
 
     <para>
-        The base class is special in that every <filename>.bb</filename>
-        file inherits it automatically.
+        The <filename>base</filename> class is special in that every
+        <filename>.bb</filename> file automatically inherits the class.
         This class contains definitions for standard basic
-        tasks such as fetching, unpacking, configuring (empty by default), compiling
-        (runs any <filename>Makefile</filename> present), installing (empty by default) and packaging
-        (empty by default).
+        tasks such as fetching, unpacking, configuring (empty by default),
+        compiling (runs any <filename>Makefile</filename> present), installing
+        (empty by default) and packaging (empty by default).
         These classes are often overridden or extended by other classes
-        such as <filename>autotools.bbclass</filename> or <filename>package.bbclass</filename>.
-        The class also contains some commonly used functions such as <filename>oe_runmake</filename>.
+        such as the
+        <link linkend='ref-classes-autotools'><filename>autotools</filename></link>
+        class or the
+        <link linkend='ref-classes-package'><filename>package</filename></link>
+        class.
+        The class also contains some commonly used functions such as
+        <filename>oe_runmake</filename>.
     </para>
 </section>