diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml
index 45fd698cd9..bbaaf50ef3 100644
--- a/documentation/ref-manual/ref-classes.xml
+++ b/documentation/ref-manual/ref-classes.xml
@@ -2710,15 +2710,15 @@
     <para>
         Other classes use the <filename>terminal</filename> class anywhere a
         separate terminal session needs to be started.
-        The class is used by including the
+        For example, the
         <link linkend='ref-classes-patch'><filename>patch</filename></link>
-        class if
+        class assuming
         <link linkend='var-PATCHRESOLVE'><filename>PATCHRESOLVE</filename></link>
-        is set to "user", include the
+        is set to "user", the
         <link linkend='ref-classes-cml1'><filename>cml1</filename></link>
-        class, and include the
+        class, and the
         <link linkend='ref-classes-devshell'><filename>devshell</filename></link>
-        class.
+        class all use the <filename>terminal</filename> class.
     </para>
 </section>