diff --git a/documentation/dev-manual/dev-manual-newbie.xml b/documentation/dev-manual/dev-manual-newbie.xml
index 8b58bb675e..8ab6ecf662 100644
--- a/documentation/dev-manual/dev-manual-newbie.xml
+++ b/documentation/dev-manual/dev-manual-newbie.xml
@@ -1005,7 +1005,8 @@
- Following are general instructions for both pushing changes upstream and for submitting changes as patches.
+ Following are general instructions for both pushing changes upstream and for submitting
+ changes as patches.
@@ -1029,6 +1030,11 @@
send-pull-request.
You can find these scripts in the scripts directory of the
Yocto Project file structure.
+ Using these scripts correctly formats the requests without introducing any
+ whitespace or HTML formatting.
+ The maintainer that receives your patches needs to be able to save and apply them
+ directly from your emails.
+ Using these scripts is the preferred method for sending patches.
For help on using these scripts, simply provide the
-h argument as follows: