diff --git a/R/aaa.R b/R/aaa.R
index 3a4920d2b..82ad37323 100644
--- a/R/aaa.R
+++ b/R/aaa.R
@@ -69,6 +69,10 @@ the <- new.env(parent = emptyenv())
 #' `on_load()` is implemented via `.onLoad()` and requires
 #' `run_on_load()` to be called from that hook.
 #'
+#' The expressions inside `on_load()` do not undergo static analysis
+#' by `R CMD check`. Therefore, it is advisable to only use
+#' simple function calls inside `on_load()`.
+#'
 #' @examples
 #' quote({  # Not run
 #' 
diff --git a/man/on_load.Rd b/man/on_load.Rd
index b99c56287..bd75be995 100644
--- a/man/on_load.Rd
+++ b/man/on_load.Rd
@@ -72,6 +72,10 @@ disparate expressions in a single block.
 
 \code{on_load()} is implemented via \code{.onLoad()} and requires
 \code{run_on_load()} to be called from that hook.
+
+The expressions inside \code{on_load()} do not undergo static analysis
+by \verb{R CMD check}. Therefore, it is advisable to only use
+simple function calls inside \code{on_load()}.
 }
 
 \examples{