Add descriptions to administrative monitors (jenkinsci#5937)

Co-authored-by: Daniel Beck <[email protected]>

core/src/main/resources/hudson/PluginManager/PluginCycleDependenciesMonitor/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/hudson/PluginManager/PluginCycleDependenciesMonitor/description.properties

@@ -0,0 +1 @@
+blurb = When Jenkins detects a cyclic dependency between plugins (a bug in one or more plugins), this message is shown.

core/src/main/resources/hudson/PluginManager/PluginDeprecationMonitor/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/hudson/PluginManager/PluginDeprecationMonitor/description.properties

@@ -0,0 +1,2 @@
+blurb = Informs administrators about the deprecation of one or more currently installed plugins. \
+  This is metadata provided by the configured update sites, and the plugin documentation will usually explain why the plugin is deprecated.

core/src/main/resources/hudson/PluginManager/PluginUpdateMonitor/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/hudson/PluginManager/PluginUpdateMonitor/description.properties

@@ -0,0 +1,3 @@
+blurb = Informs administrators about a required plugin update. \
+  This is unrelated to plugin updates being available.
+# TODO Is this even used anymore?

core/src/main/resources/hudson/PluginWrapper/PluginWrapperAdministrativeMonitor/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/hudson/PluginWrapper/PluginWrapperAdministrativeMonitor/description.properties

@@ -0,0 +1,2 @@
+blurb = If any plugins failed to load, this informs administrators about the problem. \
+  This is a severe problem, as re-saving configuration at this point could result in the loss of configuration data related to unloadable plugins.

core/src/main/resources/hudson/diagnosis/HudsonHomeDiskUsageMonitor/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/hudson/diagnosis/HudsonHomeDiskUsageMonitor/description.properties

@@ -0,0 +1 @@
+blurb = This warning shows up when the available disk space for the Jenkins home directory falls below a certain threshold.

core/src/main/resources/hudson/diagnosis/NullIdDescriptorMonitor/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/hudson/diagnosis/NullIdDescriptorMonitor/description.properties

@@ -0,0 +1 @@
+blurb = Informs administrators about a problem with extensions in some legacy plugins.

core/src/main/resources/hudson/diagnosis/OldDataMonitor/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/hudson/diagnosis/OldDataMonitor/description.properties

@@ -0,0 +1,2 @@
+blurb = When Jenkins configuration files contain unloadable data, this informs administrators about the problem. \
+  A common cause is plugins having been downgraded, or having changed in backwards-incompatible ways.

core/src/main/resources/hudson/diagnosis/ReverseProxySetupMonitor/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/hudson/diagnosis/ReverseProxySetupMonitor/description.properties

@@ -0,0 +1 @@
+blurb = If Jenkins is running behind a reverse proxy, this identifies problems with a bad configuration.

core/src/main/resources/hudson/diagnosis/TooManyJobsButNoView/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/hudson/diagnosis/TooManyJobsButNoView/description.properties

@@ -0,0 +1 @@
+blurb = Recommends the creation of additional views to help categorize jobs if there are none and too many jobs exist.

core/src/main/resources/hudson/model/UpdateCenter/CoreUpdateMonitor/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/hudson/model/UpdateCenter/CoreUpdateMonitor/description.properties

@@ -0,0 +1 @@
+blurb = When a new release of Jenkins has been released, this informs administrators about it.

core/src/main/resources/hudson/node_monitors/MonitorMarkedNodeOffline/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/hudson/node_monitors/MonitorMarkedNodeOffline/description.properties

@@ -0,0 +1 @@
+blurb = Whenever a resource monitor marks a node offline, this warning is shown to inform administrators about it.

core/src/main/resources/hudson/triggers/SCMTrigger/AdministrativeMonitorImpl/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/hudson/triggers/SCMTrigger/AdministrativeMonitorImpl/description.properties

@@ -0,0 +1 @@
+blurb = If there are more SCM polling activities scheduled than Jenkins can handle in parallel, this informs administrators about the problem and provides diagnostic information.

core/src/main/resources/hudson/triggers/SlowTriggerAdminMonitor/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/hudson/triggers/SlowTriggerAdminMonitor/description.properties

@@ -0,0 +1 @@
+blurb = This warns administrators that triggers are not firing on schedule, typically because some plugins perform additional actions (like network access) during trigger processing.

core/src/main/resources/jenkins/diagnosis/HsErrPidList/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/jenkins/diagnosis/HsErrPidList/description.properties

@@ -0,0 +1 @@
+blurb = Informs about the presence of JRE crash dumps after an abnormal Jenkins termination, and allows viewing them.

core/src/main/resources/jenkins/diagnostics/CompletedInitializationMonitor/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/jenkins/diagnostics/CompletedInitializationMonitor/description.properties

@@ -0,0 +1 @@
+blurb = Warns about an incomplete initialization, indicating a bug in Jenkins.

core/src/main/resources/jenkins/diagnostics/ControllerExecutorsAgents/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/jenkins/diagnostics/ControllerExecutorsAgents/description.properties

@@ -0,0 +1 @@
+blurb = Shows a warning when the built-in node has executors despite agents (static or clouds) being configured.

core/src/main/resources/jenkins/diagnostics/ControllerExecutorsNoAgents/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/jenkins/diagnostics/ControllerExecutorsNoAgents/description.properties

@@ -0,0 +1 @@
+blurb = Shows a warning when the built-in node has executors and recommends that agents (static or clouds) are set up.

core/src/main/resources/jenkins/diagnostics/RootUrlNotSetMonitor/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/jenkins/diagnostics/RootUrlNotSetMonitor/description.properties

@@ -0,0 +1 @@
+blurb = Some Jenkins features require the root URL to be defined, and this warns when it is undefined.

core/src/main/resources/jenkins/diagnostics/SecurityIsOffMonitor/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/jenkins/diagnostics/SecurityIsOffMonitor/description.properties

@@ -0,0 +1 @@
+blurb = Authentication (security realm) and authorization (authorization strategy) should be set up.

core/src/main/resources/jenkins/diagnostics/URICheckEncodingMonitor/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/jenkins/diagnostics/URICheckEncodingMonitor/description.properties

@@ -0,0 +1 @@
+blurb = A diagnostic feature warnings administrators about incorrect encoding of URLs, typically with improperly set up reverse proxies or containers.

core/src/main/resources/jenkins/model/BuiltInNodeMigration/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/jenkins/model/BuiltInNodeMigration/description.properties

@@ -0,0 +1 @@
+blurb = When updating Jenkins from before 2.307, this allows administrators to migrate the built-in node name and label.

core/src/main/resources/jenkins/model/Jenkins/EnforceSlaveAgentPortAdministrativeMonitor/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/jenkins/model/Jenkins/EnforceSlaveAgentPortAdministrativeMonitor/description.properties

@@ -0,0 +1 @@
+blurb = Informs administrators that the TCP agent port is different than its enforced value and will be reset on restart.

core/src/main/resources/jenkins/monitor/JavaVersionRecommendationAdminMonitor/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/jenkins/monitor/JavaVersionRecommendationAdminMonitor/description.properties

@@ -0,0 +1 @@
+blurb = Recommends Java 11 for running Jenkins if an older version is used.

core/src/main/resources/jenkins/security/QueueItemAuthenticatorMonitor/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/jenkins/security/QueueItemAuthenticatorMonitor/description.properties

@@ -0,0 +1 @@
+blurb = If access control for builds is not set up, this shows a warning, explaining the problem.

core/src/main/resources/jenkins/security/RekeySecretAdminMonitor/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/jenkins/security/RekeySecretAdminMonitor/description.properties

@@ -0,0 +1 @@
+blurb = Informs about the need to perform secret re-keying due to <a href="https://www.jenkins.io/redirect/rekey" rel="noopener noreferrer" target="_blank">a security vulnerability</a> that was fixed in 2013.

core/src/main/resources/jenkins/security/ResourceDomainRecommendation/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/jenkins/security/ResourceDomainRecommendation/description.properties

@@ -0,0 +1 @@
+blurb = Informs about the resource root URL option if the <code>Content-Security-Policy</code> HTTP header for user-controlled resources served by Jenkins has been set to a custom value.

core/src/main/resources/jenkins/security/UpdateSiteWarningsMonitor/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/jenkins/security/UpdateSiteWarningsMonitor/description.properties

@@ -0,0 +1,3 @@
+blurb = This warning informs administrators about active security warnings for installed Jenkins core or plugin versions. \
+  Rather than disable this warning entirely (including any future issues), consider disabling specific messages in the global security configuration.
+# TODO Add link

core/src/main/resources/jenkins/security/apitoken/ApiTokenPropertyDisabledDefaultAdministrativeMonitor/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/jenkins/security/apitoken/ApiTokenPropertyDisabledDefaultAdministrativeMonitor/description.properties

@@ -0,0 +1 @@
+blurb = Warns administrators about the legacy behavior of automatically generating API tokens for new users.

core/src/main/resources/jenkins/security/apitoken/ApiTokenPropertyEnabledNewLegacyAdministrativeMonitor/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/jenkins/security/apitoken/ApiTokenPropertyEnabledNewLegacyAdministrativeMonitor/description.properties

@@ -0,0 +1 @@
+blurb = Warns administrators about the legacy behavior of allowing users to generate new legacy API tokens.

core/src/main/resources/jenkins/security/apitoken/LegacyApiTokenAdministrativeMonitor/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/jenkins/security/apitoken/LegacyApiTokenAdministrativeMonitor/description.properties

@@ -0,0 +1 @@
+blurb = Warns administrators about the presence of legacy API tokens in the configuration of some users.

core/src/main/resources/jenkins/security/csrf/CSRFAdministrativeMonitor/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/jenkins/security/csrf/CSRFAdministrativeMonitor/description.properties

@@ -0,0 +1 @@
+blurb = Warns about disabled <a href="https://www.jenkins.io/redirect/csrf-protection" rel="noopener noreferrer" target="_blank">CSRF protection</a>.

core/src/main/resources/jenkins/security/s2m/AdminCallableMonitor/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/jenkins/security/s2m/AdminCallableMonitor/description.properties

@@ -0,0 +1,3 @@
+blurb = An agent attempted to send a message to the controller for execution, but agent-to-controller access control rejected it. \
+  This lets administrators review the message type and approve it.
+# TODO I am fairly sure this never triggers, but https://github.com/jenkinsci/jenkins/pull/5885 will hopefully remove this soon anyway.

core/src/main/resources/jenkins/security/s2m/MasterKillSwitchWarning/description.jelly

@@ -0,0 +1,4 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:l="/lib/layout" xmlns:f="/lib/form" xmlns:i="jelly:fmt" xmlns:st="jelly:stapler">
+    ${%blurb}
+</j:jelly>

core/src/main/resources/jenkins/security/s2m/MasterKillSwitchWarning/description.properties

@@ -0,0 +1 @@
+blurb = When <a href="https://www.jenkins.io/doc/book/security/controller-isolation/#agent-controller-access-control" rel="noopener noreferrer" target="_blank">agent-to-controller access control</a> is disabled, this warns administrators.