diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml
index 2b5cb88efd..0a41472bec 100644
--- a/documentation/ref-manual/ref-classes.xml
+++ b/documentation/ref-manual/ref-classes.xml
@@ -3298,7 +3298,7 @@ This check was removed for YP 2.3 release
                 <filename>recipe-sysroot</filename> and
                 <filename>recipe-sysroot-native</filename> in the recipe
                 work directory (i.e.
-                <link linkend='var-WORKDIR'><filename>WORKDIR</filename></link>.
+                <link linkend='var-WORKDIR'><filename>WORKDIR</filename></link>).
                 The OpenEmbedded build system creates hard links to copies of the
                 relevant files from <filename>sysroot-components</filename>
                 into the recipe work directory.
@@ -3315,9 +3315,9 @@ This check was removed for YP 2.3 release
                 within the sysroot that have the prefix
                 "<filename>postinst-</filename>" are executed.
                 <note>
-                    Although these files are not recommended for general use,
-                    the files do allow some issues such as user creation
-                    and module indexes to be addressed.
+                    Although such sysroot post installation scripts are not
+                    recommended for general use, the files do allow some issues
+                    such as user creation and module indexes to be addressed.
                 </note>
                 </para>