diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml
index f9a1771d16..41a663394a 100644
--- a/documentation/ref-manual/ref-classes.xml
+++ b/documentation/ref-manual/ref-classes.xml
@@ -335,13 +335,13 @@
         the fact that it processes more metadata.
         For example, this information includes individual file types, file checksum generation
         and evaluation on install, sparse file support, conflict detection and resolution
-        for multilib systems, ACID style upgrade, and repackaging abilities for rollbacks.
+        for Multilib systems, ACID style upgrade, and repackaging abilities for rollbacks.
     </para>
 
     <para>
         Another consideration for packages built using the RPM package manager is space.
         For smaller systems, the extra space used for the Berkley Database and the amount
-        of metadata can affect your ability to do on-device upgrades.
+        of metadata can affect your ability to perform on-device upgrades.
     </para>
 
     <para>