diff --git a/documentation/ref-manual/usingpoky.xml b/documentation/ref-manual/usingpoky.xml
index 41f872c07e..e9f4283766 100644
--- a/documentation/ref-manual/usingpoky.xml
+++ b/documentation/ref-manual/usingpoky.xml
@@ -923,10 +923,11 @@
                 <filename>BB_NUMBER_PARSE_THREADS</filename>, and
                 <filename>PARALLEL_MAKE</filename>:
                 As previously mentioned, the build system scales the values
-                for these variables.
-                However, you can manually override them in your
-                <filename>local.conf</filename> file if you are not satisfied
-                with the defaults.
+                for these variables so you should probably not override
+                these to try to speed up a build.
+                However, for completeness regarding this list, it is worth
+                mentioning that you can manually override these variables
+                by setting them in your <filename>local.conf</filename> file.
                 </para></listitem>
             <listitem><para>
                 File system type: