diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml
index 2f91e342f2..d987772058 100644
--- a/documentation/ref-manual/migration.xml
+++ b/documentation/ref-manual/migration.xml
@@ -1188,6 +1188,21 @@
             </para>
         </section>
 
+        <section id='migration-1.6-bitbake-console-output'>
+            <title>Console Output Error Redirection</title>
+
+            <para>
+                The BitBake console UI will now output errors to
+                <filename>stderr</filename> instead of
+                <filename>stdout</filename>.
+                Consequently, if you are piping or redirecting the output of
+                <filename>bitbake</filename> to somewhere else, and you wish
+                to retain the errors, you will need to add
+                <filename>2>&amp;1</filename> (or something similar) to the
+                end of your <filename>bitbake</filename> command line.
+            </para>
+        </section>
+
         <section id='migration-1.6-task-taskname-overrides'>
             <title><filename>task-&lt;taskname&gt;</filename> Overrides</title>