diff --git a/core/src/main/java/hudson/Extension.java b/core/src/main/java/hudson/Extension.java
index eb5a8d23f136..fe7872fb316d 100644
--- a/core/src/main/java/hudson/Extension.java
+++ b/core/src/main/java/hudson/Extension.java
@@ -99,6 +99,12 @@
      * The "MayBe" value indicates that there's no such explicit sign-off. So the dynamic loading may or may not
      * work.
      *
+     * <p>
+     * If your plugin contains any extension that has dynamic loadability set to NO, then Jenkins
+     * will prompt the user to restart Jenkins to have the plugin take effect. If every component
+     * is marked as YES, then Jenkins will simply dynamic load the plugin without asking the user.
+     * Otherwise, Jenkins will ask the user if he wants to restart, or go ahead and dynamically deploy.
+     *
      * @since 1.DynamicExtensionFinder
      */
     YesNoMaybe dynamicLoadable() default MAYBE;