diff --git a/documentation/dev-manual/dev-manual-newbie.xml b/documentation/dev-manual/dev-manual-newbie.xml
index 5ea6194ae0..8b58bb675e 100644
--- a/documentation/dev-manual/dev-manual-newbie.xml
+++ b/documentation/dev-manual/dev-manual-newbie.xml
@@ -987,11 +987,11 @@
                 your detailed description.
                 For example, the Yocto Project uses a specific convention for bug
                 references - any commit that addresses a specific bug should include the
-                bug ID in the description (typically at the end) as follows:
+                bug ID in the description (typically at the beginning) as follows:
                 <literallayout class='monospaced'>
-     &lt;detailed description of change&gt;
-
      [YOCTO #&lt;bug-id&gt;]
+
+     &lt;detailed description of change&gt;
                 </literallayout></para></listitem>
                 Where &lt;bug-id&gt; is replaced with the specific bug ID from the
                 Yocto Project Bugzilla instance.
@@ -1009,7 +1009,7 @@
     </para> 
 
     <section id='pushing-a-change-upstream'>
-        <title>Pushing a Change Upstream and Requesting a Pull</title>
+        <title>Using Scripts to Push a Change Upstream and Request a Pull</title>
 
         <para>
             The basic flow for pushing a change to an upstream "contrib" Git repository is as follows:
@@ -1100,8 +1100,8 @@
                     see <filename>GIT_FORMAT_PATCH(1)</filename> displayed using the  
                     <filename>man git-format-patch</filename> command.</para>
                     <note>If you have many patches to submit, you might consider using the 
-                    method described in the "<link linkend='pushing-a-change-upstream'>Pushing
-                    a change Upstream and Requesting a Pull</link>" section described 
+                    method described in the "<link linkend='pushing-a-change-upstream'>Using Scripts to Push
+                    a change Upstream and Request a Pull</link>" section described 
                     earlier in the manual.
                     This method uses the <filename>create-pull-request</filename> and 
                     <filename>send-pull-request</filename> scripts that automate much of the 
diff --git a/documentation/kernel-manual/kernel-how-to.xml b/documentation/kernel-manual/kernel-how-to.xml
index 6db88de5f7..a44e5ea51e 100644
--- a/documentation/kernel-manual/kernel-how-to.xml
+++ b/documentation/kernel-manual/kernel-how-to.xml
@@ -369,8 +369,8 @@
                 The Yocto Project provides scripts that help you work in a collaborative development 
                 environment.  
                 For information on these scripts, see the
-                "<ulink url='&YOCTO_DOCS_DEV_URL;#pushing-a-change-upstream'>Pushing a Change 
-                Upstream and Requesting a Pull</ulink>" and   
+                "<ulink url='&YOCTO_DOCS_DEV_URL;#pushing-a-change-upstream'>Using Scripts to Push a Change 
+                Upstream and Request a Pull</ulink>" and   
                 "<ulink url='&YOCTO_DOCS_DEV_URL;#submitting-a-patch'>Submitting a Patch Through 
                 Email</ulink>" sections in the Yocto Project Development Manual.
             </para>