diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 1581059891..e7d1ca4cff 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -907,8 +907,9 @@
                 allows you to add packages and is not as flexible as creating
                 your own customized image.
                 When you add packages using local variables this way, you need
-                to realize that these variable changes affect all images at
-                the same time and might not be what you require.
+                to realize that these variable changes are in effect for every
+                build and consequently affect all images, which might not
+                be what you require.
             </para>
 
             <para>
@@ -948,8 +949,8 @@
                 <literallayout class='monospaced'>
      IMAGE_INSTALL_append_pn-core-image-minimal = " strace"
                 </literallayout>
-                This example adds <filename>strace</filename> to
-                <filename>core-image-minimal</filename> only.
+                This example adds <filename>strace</filename> to the
+                <filename>core-image-minimal</filename> image only.
             </para>
 
             <para>