diff --git a/components/cli/docs/sources/reference/builder.rst b/components/cli/docs/sources/reference/builder.rst
index 4b6a151006..6fabd6629d 100644
--- a/components/cli/docs/sources/reference/builder.rst
+++ b/components/cli/docs/sources/reference/builder.rst
@@ -466,6 +466,8 @@ For example you might add something like this:
     ONBUILD RUN /usr/local/bin/python-build --dir /app/src
     [...]
 
+.. warning:: Chaining ONBUILD instructions using `ONBUILD ONBUILD` isn't allowed.
+.. warning:: ONBUILD may not trigger FROM or MAINTAINER instructions.
 
 .. _dockerfile_examples: