doc improvement about the semantics of this value

jglick · Nov 16, 2011 · da0f526 · da0f526
1 parent 6b7d75f
commit da0f526
Showing 1 changed file with 6 additions and 0 deletions.
diff --git 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;