diff --git a/documentation/ref-manual/ref-varlocality.xml b/documentation/ref-manual/ref-varlocality.xml
index ae8f75c2f5..49d9a2dc68 100644
--- a/documentation/ref-manual/ref-varlocality.xml
+++ b/documentation/ref-manual/ref-varlocality.xml
@@ -6,7 +6,7 @@
     <title>Variable Context</title>
 
     <para>
-        While most variables can be used in almost any context such as
+        While you can use most variables in almost any context such as
         <filename>.conf</filename>, <filename>.bbclass</filename>,
         <filename>.inc</filename>, and <filename>.bb</filename> files,
         some variables are often associated with a particular locality or context.
@@ -25,7 +25,8 @@
             <title>Distribution (Distro)</title>
 
             <para>
-               This section lists variables whose context is the distribution, or distro.
+               This section lists variables whose configuration context is the
+               distribution, or distro.
                <itemizedlist>
                    <listitem><para><filename><link linkend='var-DISTRO'>DISTRO</link></filename></para></listitem>
                    <listitem><para><filename><link linkend='var-DISTRO_NAME'>DISTRO_NAME</link></filename>
@@ -52,7 +53,8 @@
             <title>Machine</title>
 
             <para>
-                This section lists variables whose context is the machine.
+                This section lists variables whose configuration context is the
+                machine.
                 <itemizedlist>
                     <listitem><para><filename><link linkend='var-TARGET_ARCH'>TARGET_ARCH</link></filename>
                         </para></listitem>
@@ -80,8 +82,9 @@
             <title>Local</title>
 
             <para>
-                This section lists variables whose context is the local configuration through the
-                <filename>local.conf</filename> file.
+                This section lists variables whose configuratoin context is the
+                local configuration through the <filename>local.conf</filename>
+                file.
                 <itemizedlist>
                     <listitem><para><filename><link linkend='var-DISTRO'>DISTRO</link></filename>
                         </para></listitem>