diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml
index 8f25c521c6..8fc0449ff9 100644
--- a/documentation/ref-manual/ref-classes.xml
+++ b/documentation/ref-manual/ref-classes.xml
@@ -2258,6 +2258,14 @@
functionality specific to the respective SDK machine or target
case.
+ Warning
+ When creating a recipe, you must follow this naming convention:
+
+ nativesdk-myrecipe.bb
+
+ Not doing so can lead to subtle problems because code exists
+ that depends on the naming convention.
+