Align appendix edits with source code

Port editing changes from append to java source files to ensure that
IDE meta-data also reflects the improvements.

Closes gh-10870

Author: philwebb

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/endpoint/web/servlet/CorsEndpointProperties.java

@@ -56,7 +56,7 @@ public class CorsEndpointProperties {
 	private List<String> exposedHeaders = new ArrayList<>();
 
 	/**
-	 * Set whether credentials are supported. When not set, credentials are not supported.
+	 * Whether credentials are supported. When not set, credentials are not supported.
 	 */
 	private Boolean allowCredentials;
 

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/health/HealthIndicatorProperties.java

@@ -38,7 +38,7 @@ public class HealthIndicatorProperties {
 
 	/**
 	 * Mapping of health statuses to HTTP status codes. By default, registered health
-	 * statuses map to sensible defaults (i.e. UP maps to 200).
+	 * statuses map to sensible defaults (for example, UP maps to 200).
 	 */
 	private final Map<String, Integer> httpMapping = new HashMap<>();
 

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/jolokia/JolokiaProperties.java

@@ -33,12 +33,12 @@
 public class JolokiaProperties {
 
 	/**
-	 * Enable Jolokia.
+	 * Whether to enable Jolokia.
 	 */
 	private boolean enabled;
 
 	/**
-	 * Path at which Jolokia will be available.
+	 * Path at which Jolokia is available.
 	 */
 	private String path = "/jolokia";
 

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/metrics/MetricsProperties.java

@@ -30,9 +30,9 @@ public class MetricsProperties {
 	private Web web = new Web();
 
 	/**
-	 * Whether or not auto-configured MeterRegistry implementations should be bound to the
-	 * global static registry on Metrics. For testing, set this to 'false' to maximize
-	 * test independence.
+	 * Whether auto-configured MeterRegistry implementations should be bound to the global
+	 * static registry on Metrics. For testing, set this to 'false' to maximize test
+	 * independence.
 	 */
 	private boolean useGlobalRegistry = true;
 
@@ -73,8 +73,8 @@ public void setServer(Server server) {
 		public static class Client {
 
 			/**
-			 * Whether or not instrumented requests record percentiles histogram buckets
-			 * by default.
+			 * Whether instrumented requests record percentiles histogram buckets by
+			 * default.
 			 */
 			private boolean recordRequestPercentiles;
 
@@ -104,10 +104,10 @@ public void setRequestsMetricName(String requestsMetricName) {
 		public static class Server {
 
 			/**
-			 * Whether or not requests handled by Spring MVC or WebFlux should be
-			 * automatically timed. If the number of time series emitted grows too large
-			 * on account of request mapping timings, disable this and use 'Timed' on a
-			 * per request mapping basis as needed.
+			 * Whether requests handled by Spring MVC or WebFlux should be automatically
+			 * timed. If the number of time series emitted grows too large on account of
+			 * request mapping timings, disable this and use 'Timed' on a per request
+			 * mapping basis as needed.
 			 */
 			private boolean autoTimeRequests = true;
 

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/metrics/export/StepRegistryProperties.java

@@ -34,17 +34,17 @@ public abstract class StepRegistryProperties {
 	private Duration step = Duration.ofMinutes(1);
 
 	/**
-	 * Enable publishing to the backend.
+	 * Whether exporting of metrics to this backend is enabled.
 	 */
 	private Boolean enabled;
 
 	/**
-	 * Connection timeout for requests to the backend.
+	 * Connection timeout for requests to this backend.
 	 */
 	private Duration connectTimeout;
 
 	/**
-	 * Read timeout for requests to the backend.
+	 * Read timeout for requests to this backend.
 	 */
 	private Duration readTimeout;
 
@@ -54,7 +54,7 @@ public abstract class StepRegistryProperties {
 	private Integer numThreads;
 
 	/**
-	 * Number of measurements per request to use for the backend. If more measurements
+	 * Number of measurements per request to use for this backend. If more measurements
 	 * are found, then multiple requests will be made.
 	 */
 	private Integer batchSize;

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/web/server/ManagementServerProperties.java

@@ -47,12 +47,14 @@ public class ManagementServerProperties implements SecurityPrerequisite {
 	private Ssl ssl;
 
 	/**
-	 * Network address that the management endpoints should bind to.
+	 * Network address that to which the management endpoints should bind to. Requires a
+	 * custom management.server.port.
 	 */
 	private InetAddress address;
 
 	/**
-	 * Management endpoint context-path.
+	 * Management endpoint context-path. For instance, '/actuator'. Requires a custom
+	 * management.server.port.
 	 */
 	private String contextPath = "";