diff --git a/simple-component/src/main/java/io/jbock/simple/Inject.java b/simple-component/src/main/java/io/jbock/simple/Inject.java
index cba7b11..48d255c 100644
--- a/simple-component/src/main/java/io/jbock/simple/Inject.java
+++ b/simple-component/src/main/java/io/jbock/simple/Inject.java
@@ -8,7 +8,18 @@
import static java.lang.annotation.RetentionPolicy.RUNTIME;
/**
- * Identifies injectable constructors and static methods.
+ * Identifies injectable constructors and {@code static} methods.
+ * An {@code @Inject}-annotated static method is allowed in the following places:
+ *
+ *
+ * - The method can be a direct child of the class or interface
+ * that defines its return type.
+ *
- If the class or interface that defines its return type is nested
+ * inside an enclosing class, then the method may also be a direct child of the
+ * enclosing class.
+ *
- The method can be a direct child of the component interface.
+ * Alternatively, the {@link Provides} annotation can be used in that case.
+ *
*/
@Target({METHOD, CONSTRUCTOR})
@Retention(RUNTIME)
diff --git a/simple-component/src/main/java/io/jbock/simple/Provides.java b/simple-component/src/main/java/io/jbock/simple/Provides.java
index 936a3e3..bf6a3fc 100644
--- a/simple-component/src/main/java/io/jbock/simple/Provides.java
+++ b/simple-component/src/main/java/io/jbock/simple/Provides.java
@@ -7,8 +7,8 @@
import static java.lang.annotation.RetentionPolicy.SOURCE;
/**
- * This is an alternative to the {@code @Inject} annotation
- * which can only be used on static methods directly in the component.
+ * An alternative to the {@code @Inject} annotation that can be used
+ * on static methods which are direct children of the component interface.
*/
@Target(METHOD)
@Retention(SOURCE)