Updating javadoc based on PR feedback

core/src/main/java/hudson/Plugin.java

@@ -48,7 +48,10 @@ import com.thoughtworks.xstream.XStream;
  * Base class of Hudson plugin.
  *
  * <p>
- * A plugin may derive from this class.
+ * A plugin may derive from this class, or it may directly define extension
+ * points annotated with {@link hudson.Extension}. For a list of extension
+ * points, see <a href="https://wiki.jenkins-ci.org/display/JENKINS/Extension+points">
+ * https://wiki.jenkins-ci.org/display/JENKINS/Extension+points</a>.
  *
  * <p>
  * One instance of a plugin is created by Hudson, and used as the entry point

core/src/main/java/hudson/model/labels/LabelAtomProperty.java

@@ -40,19 +40,9 @@ import java.util.Collections;
  * Plugins can contribute this extension point to add additional data or UI actions to {@link LabelAtom}.
  * {@link LabelAtomProperty}s show up in the configuration screen of a label, and they are persisted
  * with the {@link LabelAtom} object.
- * 
- * <h2>Implementation hints</h2>
- * <ul>
- * <li>extend this class and define a static inner class extending {@link hudson.model.labels.LabelAtomPropertyDescriptor}</li>
- * <li>in the inner class override <code>getDisplayName()</code>. This function returns the name of the option shown in the label
- * configuration page to activate your extension</li>
- * <li>if you need additional parameters in this page when activating your extension, provide a <tt>config.jelly</tt> file</li>
- * <li>when the user saves the label configuration page with your extension activated, Jenkins calls the corresponding
- * {@link org.kohsuke.stapler.DataBoundConstructor}-annotated constructor in your LabelAtomProperty subclass</li>
- * <li>override the <code>getActions()</code> function to return your additional {@link hudson.model.Action}(s)</li>
- * </ul>
  *
  * @author Kohsuke Kawaguchi
+ * @see hudson.model.labels.LabelAtomPropertyDescriptor
  * @since 1.373
  */
 @ExportedBean

core/src/main/java/hudson/model/labels/LabelAtomPropertyDescriptor.java

@@ -31,6 +31,11 @@ import hudson.model.Descriptor;
  *
  * <p>
  * Put {@link Extension} on your descriptor implementation to have it auto-registered.
+ * 
+ * <p>
+ * When extending this class, override <code>Descriptor.getDisplayName()</code>. In the
+ * context of LabelAtomPropertyDescriptor, this function is used to determine the label of
+ * the checkbox shown in the label's configuration page to activate the extension.
  *
  * @author Kohsuke Kawaguchi
  * @since 1.373