diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml
index eaab17258d..be68fce8ee 100644
--- a/documentation/ref-manual/ref-classes.xml
+++ b/documentation/ref-manual/ref-classes.xml
@@ -2850,8 +2850,8 @@
     <title><filename>externalsrc.bbclass</filename></title>
 
     <para>
-        You can use this class to build software from source code that is
-        external to the OpenEmbedded build system.
+        The <filename>externalsrc</filename> class supports building software
+        from source code that is external to the OpenEmbedded build system.
         Building software from an external source tree means that the build
         system's normal fetch, unpack, and patch process is not used.
     </para>
@@ -2861,7 +2861,7 @@
         <link linkend='var-S'><filename>S</filename></link> and
         <link linkend='var-B'><filename>B</filename></link> variables to
         locate unpacked recipe source code and to build it, respectively.
-        When your recipe inherits <filename>externalsrc.bbclass</filename>,
+        When your recipe inherits the <filename>externalsrc</filename> class,
         you use the
         <link linkend='var-EXTERNALSRC'><filename>EXTERNALSRC</filename></link>
         and
@@ -2881,19 +2881,19 @@
         <literallayout class='monospaced'>
      ${WORKDIR}/${BPN}/{PV}/
         </literallayout>
-        See the glossary entries for the
+        See these variables for more information:
         <link linkend='var-WORKDIR'><filename>WORKDIR</filename></link>,
-        <link linkend='var-BPN'><filename>BPN</filename></link>,
+        <link linkend='var-BPN'><filename>BPN</filename></link>, and
         <link linkend='var-PV'><filename>PV</filename></link>,
     </para>
 
     <para>
-        For more information on
-        <filename>externalsrc.bbclass</filename>, see the comments in
+        For more information on the
+        <filename>externalsrc</filename> class, see the comments in
         <filename>meta/classes/externalsrc.bbclass</filename> in the
         <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>.
-        For information on how to use <filename>externalsrc.bbclass</filename>,
-        see the
+        For information on how to use the <filename>externalsrc</filename>
+        class, see the
         "<ulink url='&YOCTO_DOCS_DEV_URL;#building-software-from-an-external-source'>Building Software from an External Source</ulink>"
         section in the Yocto Project Development Manual.
     </para>