diff --git a/api/src/main/java/jakarta/enterprise/inject/build/compatible/spi/Enhancement.java b/api/src/main/java/jakarta/enterprise/inject/build/compatible/spi/Enhancement.java
index 35cee264..6a3d6438 100644
--- a/api/src/main/java/jakarta/enterprise/inject/build/compatible/spi/Enhancement.java
+++ b/api/src/main/java/jakarta/enterprise/inject/build/compatible/spi/Enhancement.java
@@ -33,6 +33,9 @@
  * the method is called once for each field that is declared on each <em>discovered type</em>, as defined
  * in {@link jakarta.enterprise.lang.model.declarations.ClassInfo#fields() ClassInfo.fields}.
  * <p>
+ * If the {@code @Enhancement} method doesn't declare any parameter of one of these types,
+ * or if it declares more than one, the container treats it as a deployment problem.
+ * <p>
  * Additionally, methods annotated {@code @Enhancement} may declare parameters of these types:
  * <ul>
  * <li>{@link Messages}</li>
diff --git a/api/src/main/java/jakarta/enterprise/inject/build/compatible/spi/Registration.java b/api/src/main/java/jakarta/enterprise/inject/build/compatible/spi/Registration.java
index a041a0dc..7fd73a90 100644
--- a/api/src/main/java/jakarta/enterprise/inject/build/compatible/spi/Registration.java
+++ b/api/src/main/java/jakarta/enterprise/inject/build/compatible/spi/Registration.java
@@ -34,6 +34,9 @@
  * Note that interceptors are beans, and {@code InterceptorInfo} is a subtype of {@code BeanInfo}, so if the method
  * has a parameter of type {@code BeanInfo}, it will be called for interceptors as well.
  * <p>
+ * If the {@code @Registration} method doesn't declare any parameter of one of these types,
+ * or if it declares more than one, the container treats it as a deployment problem.
+ * <p>
  * Additionally, methods annotated {@code @Registration} may declare parameters of these types:
  * <ul>
  * <li>{@link Messages}</li>