Refactor comments for clarity in AdministrativeMonitor

Author: LakshyaBagani

core/src/main/java/hudson/model/AdministrativeMonitor.java

@@ -70,8 +70,7 @@
  * If {@link #isActivated()} returns true, Jenkins will use the {@code message.jelly}
  * view of this object to render the warning text. This happens in the
  * {@code http://SERVER/jenkins/manage} page. This view should typically render
- * a DIV box with class='alert alert-danger' or class='alert alert-warning' with
- * a human-readable text
+ * a DIV box with class='alert alert-danger' or class='alert alert-warning' with a human-readable text
  * inside it. It often also contains a link to a page that provides more details
  * about the problem.<br>
  * Additionally 2 numbers are shown in the Jenkins header of administrators, one with the number or active
@@ -81,10 +80,10 @@
  *
  * <h3>Use with System Read permission</h3>
  * <p>
- * By default administrative monitors are visible only to users with Administer permission.
- * Users with {@link Jenkins#SYSTEM_READ} permission can access administrative monitors that override {@link #getRequiredPermission()}.
- * Care needs to be taken to ensure users with that permission don't have access to actions modifying system state.
- * For more details, see {@link #getRequiredPermission()}.
+ *     By default administrative monitors are visible only to users with Administer permission.
+ *     Users with {@link Jenkins#SYSTEM_READ} permission can access administrative monitors that override {@link #getRequiredPermission()}.
+ *     Care needs to be taken to ensure users with that permission don't have access to actions modifying system state.
+ *     For more details, see {@link #getRequiredPermission()}.
  * </p>
  *
  * @author Kohsuke Kawaguchi
@@ -111,8 +110,7 @@ protected AdministrativeMonitor() {
     }
 
     /**
-     * Returns the URL of this monitor, relative to the context path, like
-     * "administrativeMonitor/foobar".
+     * Returns the URL of this monitor, relative to the context path, like "administrativeMonitor/foobar".
      */
     public String getUrl() {
         return "administrativeMonitor/" + id;
@@ -147,7 +145,8 @@ public void disable(boolean value) throws IOException {
      * Returns true if this monitor {@link #disable(boolean) isn't disabled} earlier.
      *
      * <p>
-     * This flag implements the ability for the admin to say "no thank you" to the monitor that he wants to ignore.
+     * This flag implements the ability for the admin to say "no thank you" to the monitor that 
+     * he wants to ignore.
      */
     public boolean isEnabled() {
         if (isSnoozed()) {
@@ -298,21 +297,18 @@ public void doSnooze(StaplerRequest2 req, StaplerResponse2 rsp) throws IOExcepti
      * Required permission to view this admin monitor.
      * By default {@link Jenkins#ADMINISTER}, but {@link Jenkins#SYSTEM_READ} or {@link Jenkins#MANAGE} are also supported.
      * <p>
-     * Changing this permission check to return {@link Jenkins#SYSTEM_READ} will make the active
-     * administrative monitor appear on {@link ManageJenkinsAction} to users without Administer permission.
-     * {@link #doDisable(StaplerRequest2, StaplerResponse2)} will still always require Administer permission.
+     *     Changing this permission check to return {@link Jenkins#SYSTEM_READ} will make the active
+     *     administrative monitor appear on {@link ManageJenkinsAction} to users without Administer permission.
+     *     {@link #doDisable(StaplerRequest2, StaplerResponse2)} will still always require Administer permission.
      * </p>
      * <p>
-     * This method only allows for a single permission to be returned. If more complex permission checks are required,
-     * override {@link #checkRequiredPermission()} and {@link #hasRequiredPermission()} instead.
+     *     This method only allows for a single permission to be returned. If more complex permission checks are required,
+     *     override {@link #checkRequiredPermission()} and {@link #hasRequiredPermission()} instead.
      * </p>
      * <p>
-     * Implementers need to ensure that {@code doAct} and other web methods perform
-     * necessary permission checks:
-     * Users with System Read permissions are expected to be limited to read-only
-     * access.
-     * Form UI elements that change system state, e.g. toggling a feature on or off,
-     * need to be hidden from users
+     * Implementers need to ensure that {@code doAct} and other web methods perform necessary permission checks:
+     * Users with System Read permissions are expected to be limited to read-only access.
+     * Form UI elements that change system state, e.g. toggling a feature on or off, need to be hidden from users
      * lacking Administer permission.
      * </p>
      *
@@ -330,7 +326,6 @@ public Permission getRequiredPermission() {
      * Subclasses may override this method and {@link #hasRequiredPermission()} instead of {@link #getRequiredPermission()} to perform more complex permission checks,
      * for example, checking either {@link Jenkins#MANAGE} or {@link Jenkins#SYSTEM_READ}.
      * </p>
-     *
      * @see #getRequiredPermission()
      * @see #hasRequiredPermission()
      * @since 2.468
@@ -345,7 +340,6 @@ public void checkRequiredPermission() {
      * Subclasses may override this method and {@link #checkRequiredPermission} instead of {@link #getRequiredPermission()} to perform more complex permission checks,
      * for example, checking either {@link Jenkins#MANAGE} or {@link Jenkins#SYSTEM_READ}.
      * </p>
-     *
      * @see #getRequiredPermission()
      * @see #checkRequiredPermission()
      * @since 2.468