diff --git a/documentation/kernel-dev/kernel-dev-common.xml b/documentation/kernel-dev/kernel-dev-common.xml
index 532e2e87a6..27c82ceb58 100644
--- a/documentation/kernel-dev/kernel-dev-common.xml
+++ b/documentation/kernel-dev/kernel-dev-common.xml
@@ -646,7 +646,18 @@
files directory as "defconfig" and
then add it to the
SRC_URI
- variable in the recipe.
+ variable in the recipe.
+ Running the make defconfig
+ command results in the default configuration for your
+ architecture as defined by your kernel.
+ However, no guarantee exists that this configuration is
+ valid for your use case, or that your board will even boot.
+ This is particularly true for non-x86 architectures.
+ To use non-x86 defconfig files, you
+ need to be more specific and find one that matches your
+ board (i.e. for arm, you look in
+ arch/arm/configs and use the one that
+ is the best starting point for your board).
Edit the following variables in your recipe
as appropriate for your project: