Some documentations clean up

Author: artembilan

spring-integration-core/src/main/java/org/springframework/integration/dsl/IntegrationFlow.java

@@ -156,7 +156,7 @@ static IntegrationFlowBuilder from(MessageChannelSpec<?, ?> messageChannelSpec)
 
 	/**
 	 * Populate the {@link MessageChannel} name to the new {@link IntegrationFlowBuilder} chain.
-	 * Typically for the {@link org.springframework.integration.channel.FixedSubscriberChannel} together
+	 * Typically, for the {@link org.springframework.integration.channel.FixedSubscriberChannel} together
 	 * with {@code fixedSubscriber = true}.
 	 * The {@link IntegrationFlow} {@code inputChannel}.
 	 * @param messageChannelName the name for {@link DirectChannel} or
@@ -215,6 +215,7 @@ static IntegrationFlowBuilder from(MessageSourceSpec<?, ? extends MessageSource<
 	 */
 	static IntegrationFlowBuilder from(MessageSourceSpec<?, ? extends MessageSource<?>> messageSourceSpec,
 			Consumer<SourcePollingChannelAdapterSpec> endpointConfigurer) {
+
 		Assert.notNull(messageSourceSpec, "'messageSourceSpec' must not be null");
 		return from(messageSourceSpec.get(), endpointConfigurer, registerComponents(messageSourceSpec));
 	}
@@ -248,7 +249,7 @@ static <T> IntegrationFlowBuilder fromSupplier(Supplier<T> messageSource,
 			Consumer<SourcePollingChannelAdapterSpec> endpointConfigurer) {
 
 		Assert.notNull(messageSource, "'messageSource' must not be null");
-		return from(new AbstractMessageSource<Object>() {
+		return from(new AbstractMessageSource<>() {
 
 			@Override
 			protected Object doReceive() {
@@ -497,10 +498,9 @@ private static IntegrationFlowBuilder registerComponents(Object spec) {
 
 	@SuppressWarnings("unchecked")
 	private static <T> T extractProxyTarget(T target) {
-		if (!(target instanceof Advised)) {
+		if (!(target instanceof Advised advised)) {
 			return target;
 		}
-		Advised advised = (Advised) target;
 		try {
 			return (T) extractProxyTarget(advised.getTargetSource().getTarget());
 		}

spring-integration-core/src/main/java/org/springframework/integration/dsl/IntegrationFlows.java

@@ -41,7 +41,7 @@
  *
  * @see org.springframework.integration.dsl.context.IntegrationFlowBeanPostProcessor
  *
- * @deprecated Since version 6.0, this factory is not recommended to use as it shall be removed in the following versions. Use fluent API methods straight from {@link IntegrationFlow} interface.
+ * @deprecated since version 6.0 in favor of fluent API methods straight from {@link IntegrationFlow} interface.
  */
 @Deprecated(since = "6.0", forRemoval = true)
 public final class IntegrationFlows {

src/reference/asciidoc/whats-new.adoc

@@ -50,6 +50,8 @@ See <<./aggregator.adoc#aggregator,Aggregator>> for more information.
 The `IntegrationFlows` factory is now marked as deprecated in favor of the fluent API available in the `IntegrationFlow` interface itself.
 The factory class will be removed in the future releases.
 
+See <<./dsl.adoc#java-dsl,Java DSL>> for more information.
+
 [[x6.0-http]]
 === HTTP Changes
 
@@ -74,6 +76,10 @@ See <<./kafka.adoc#kafka,Spring for Apache Kafka Support>> for more information.
 
 The `DefaultLockRepository` can now be supplied with a `PlatformTransactionManager` instead of relying on the primary bean from the application context.
 
+See <<./jdbc.adoc#jdbc-lock-registry,JDBC Lock Registry>> for more information.
+
 === TCP/IP Changes
 
-The `lookupHost` property of the `AbstractConnectionFactory` and `DatagramPacketMessageMapper` is now set to `false` by default to avoid delays in the environments where DNS is not configured.
+The `lookupHost` property of the `AbstractConnectionFactory` and `DatagramPacketMessageMapper` is now set to `false` by default to avoid delays in the environments where DNS is not configured.
+
+See <<./ip.adoc#ip,TCP and UDP Support>> for more information.