docs: Updates to Quarkus quick start for Service Registry to describe manual connection use case (#542)

* Updates to describe manual connection use case

* Restore original titles of RHOSAK quick starts. Other minor tweaks.

Author: jbyrne-redhat

README.adoc

@@ -8,13 +8,13 @@
 
 * link:./docs/kafka/getting-started-kafka[Getting started with {product-long-kafka}]
 * link:./docs/kafka/rhoas-cli-getting-started-kafka[Getting started with the rhoas CLI for {product-long-kafka}]
-* link:./docs/kafka/quarkus-kafka[Manually connecting Quarkus applications to Kafka instances in {product-long-kafka}]
+* link:./docs/kafka/quarkus-kafka[Using Quarkus applications with Kafka instances in {product-long-kafka}]
 * link:./docs/kafka/kcat-kafka[Configuring and connecting Kafkacat with {product-long-kafka}]
 * link:./docs/kafka/kafka-bin-scripts-kafka[Configuring and connecting Kafka scripts with {product-long-kafka}]
 * link:./docs/kafka/access-mgmt-kafka[Managing account access in {product-long-kafka}]
 * link:./docs/kafka/service-binding-kafka[Binding OpenShift applications to {product-long-kafka}]
 * link:./docs/kafka/topic-configuration-kafka[Configuring topics in {product-long-kafka}]
-* link:./docs/kafka/nodejs-kafka[Manually connecting Node.js applications to Kafka instances in {product-long-kafka}]
+* link:./docs/kafka/nodejs-kafka[Using Node.js applications with Kafka instances in {product-long-kafka}]
 * link:./docs/kafka/metrics-monitoring-kafka[Monitoring metrics in {product-long-kafka}]
 * link:./docs/kafka/consumer-configuration-kafka[Configuring consumer groups in {product-long-kafka}]
 

docs/kafka/getting-started-kafka/README.adoc

@@ -350,7 +350,7 @@ endif::[]
 * {base-url-cli}{command-ref-url-cli}[CLI command reference (rhoas)^]
 * {base-url}{kafkacat-url-kafka}[Configuring and connecting Kafkacat with {product-long-kafka}^]
 * {base-url}{kafka-bin-scripts-url-kafka}[Configuring and connecting Kafka scripts with {product-long-kafka}^]
-* {base-url}{quarkus-url-kafka}[Manually connecting Quarkus applications to Kafka instances in {product-long-kafka}^]
+* {base-url}{quarkus-url-kafka}[Using Quarkus applications with Kafka instances in {product-long-kafka}^]
 
 ifdef::qs[]
 [#conclusion]

docs/kafka/nodejs-kafka/README.adoc

@@ -74,15 +74,15 @@ END GENERATED ATTRIBUTES
 ////
 
 [id="chap-using-nodejs"]
-= Manually connecting Node.js applications to Kafka instances in {product-long-kafka}
+= Using Node.js applications with Kafka instances in {product-long-kafka}
 ifdef::context[:parent-context: {context}]
 :context: using-nodejs
 
 // Purpose statement for the assembly
 [role="_abstract"]
 As a developer of applications and services, you can connect Node.js applications to Kafka instances in {product-long-kafka}. https://nodejs.org/en/about/[Node.js^] is a server-side JavaScript runtime that is designed to build scalable network applications. Node.js provides an I/O model that is based on events and non-blocking operations, which enables efficient applications.
 
-In this quick start, you'll use the {product-kafka} web console to collect connection information for a Kafka instance. Then you'll manually configure a connection to the Kafka instance from an example Node.js application and start producing and consuming messages.
+In this quick start, you'll use the {product-kafka} web console to collect connection information for a Kafka instance. Then you'll manually configure a connection from an example Node.js application to the Kafka instance and start producing and consuming messages.
 
 NOTE: When you've completed this quick start and understand the required connection configuration for a Kafka instance, you can use the {product-long-rhoas} command-line interface (CLI) to generate this type of configuration in a more automated way. To learn more, see {base-url}{service-contexts-url-cli}[Connecting client applications to {product-long-rhoas} using the rhoas CLI^].
 
@@ -108,7 +108,7 @@ Learn how to manually connect a Node.js application to a Kafka instance in {prod
 
 [#introduction]
 ====
-Welcome to the quick start for {product-long-kafka} with Node.js. In this quick start, you'll use the web console to collect connection information for a Kafka instance in {product-kafka}. Then you'll manually configure a connection to the Kafka instance from an example https://nodejs.org/en/about/[Node.js^] application and start producing and consuming messages.
+Welcome to the quick start for {product-long-kafka} with Node.js. In this quick start, you'll use the web console to collect connection information for a Kafka instance in {product-kafka}. Then you'll manually configure a connection from an example https://nodejs.org/en/about/[Node.js^] application to the Kafka instance and start producing and consuming messages.
 ====
 endif::[]
 

docs/kafka/quarkus-kafka/README.adoc

@@ -74,15 +74,15 @@ END GENERATED ATTRIBUTES
 ////
 
 [id="chap-using-quarkus"]
-= Manually connecting Quarkus applications to Kafka instances in {product-long-kafka}
+= Using Quarkus applications with Kafka instances in {product-long-kafka}
 ifdef::context[:parent-context: {context}]
 :context: using-quarkus
 
 // Purpose statement for the assembly
 [role="_abstract"]
 As a developer of applications and services, you can connect Quarkus applications to Kafka instances in {product-long-kafka}. https://quarkus.io/[Quarkus^] is a Kubernetes-native Java framework made for Java virtual machines (JVMs) and native compilation, and optimized for serverless, cloud, and Kubernetes environments. Quarkus is designed to work with popular Java standards, frameworks, and libraries like Eclipse MicroProfile and Spring, as well as Apache Kafka, RESTEasy (JAX-RS), Hibernate ORM (JPA), Infinispan, Camel, and many more.
 
-In this quick start, you'll use the {product-kafka} web console to collect connection information for a Kafka instance. Then you'll manually configure a connection to the Kafka instance from an example Quarkus application and start producing and consuming messages.
+In this quick start, you'll use the {product-kafka} web console to collect connection information for a Kafka instance. Then you'll manually configure a connection from an example Quarkus application to the Kafka instance and start producing and consuming messages.
 
 NOTE: When you've completed this quick start and understand the required connection configuration for a Kafka instance, you can use the {product-long-rhoas} command-line interface (CLI) to generate this type of configuration in a more automated way. To learn more, see {base-url}{service-contexts-url-cli}[Connecting client applications to {product-long-rhoas} using the rhoas CLI^].
 
@@ -106,7 +106,7 @@ Learn how to manually connect a Quarkus application to a Kafka instance in {prod
 
 [#introduction]
 ====
-Welcome to the quick start for {product-long-kafka} with Quarkus. In this quick start, you'll use the web console to collect connection information for a Kafka instance in {product-kafka}. Then you'll manually configure a connection to the Kafka instance from an example https://quarkus.io/[Quarkus^] application and start producing and consuming messages.
+Welcome to the quick start for {product-long-kafka} with Quarkus. In this quick start, you'll use the web console to collect connection information for a Kafka instance in {product-kafka}. Then you'll manually configure a connection from an example https://quarkus.io/[Quarkus^] application to the Kafka instance and start producing and consuming messages.
 ====
 endif::[]
 

docs/registry/quarkus-registry/README.adoc

@@ -80,11 +80,13 @@ ifdef::context[:parent-context: {context}]
 
 // Purpose statement for the assembly
 [role="_abstract"]
-As a developer of applications and services, you can connect Quarkus applications to Kafka instances in {product-long-kafka} and {registry} instances in {product-long-registry}. This makes it easy for development teams to store and reuse schemas in event streaming architectures.
+As a developer of applications and services, you can connect Quarkus applications to Kafka instances in {product-long-kafka} and {registry} instances in {product-long-registry}. This makes it easy for development teams to store and reuse schemas in event-streaming architectures.
 
-https://quarkus.io/[Quarkus^] is a Kubernetes-native Java framework made for Java virtual machines (JVMs) and native compilation, and optimized for serverless, cloud, and Kubernetes environments.
+https://quarkus.io/[Quarkus^] is a Kubernetes-native Java framework made for Java virtual machines (JVMs) and native compilation, and optimized for serverless, cloud, and Kubernetes environments. Quarkus is designed to work with popular Java standards, frameworks, and libraries like Eclipse MicroProfile and Spring, as well as Apache Kafka, RESTEasy (JAX-RS), Hibernate ORM (JPA), Infinispan, Camel, and many more.
 
-Quarkus is designed to work with popular Java standards, frameworks, and libraries like Eclipse MicroProfile and Spring, as well as Apache Kafka, RESTEasy (JAX-RS), Hibernate ORM (JPA), Infinispan, Camel, and many more.
+In this quick start, you'll manually configure connections from an example Quarkus application to Kafka and {registry} instances. The application will use the Kafka instance to produce and consume messages and a schema stored in the {registry} instance to serialize/deserialize the messages.
+
+NOTE: When you've completed this quick start and understand the required connection configurations for Kafka and {registry} instances, you can use the {product-long-rhoas} command-line interface (CLI) to generate these types of configurations in a more automated way. To learn more, see {base-url}{service-contexts-url-cli}[Connecting client applications to {product-long-rhoas} using the rhoas CLI^].
 
 .Prerequisites
 ifndef::community[]
@@ -102,12 +104,12 @@ endif::[]
 ifdef::qs[]
 [#description]
 ====
-Learn how to use a Quarkus application that produces messages to and consume messages from a Kafka instance in {product-long-kafka} and manage the message schemas in {product-long-registry}.
+Learn how to manually connect a Quarkus application to a Kafka instance in {product-long-kafka} and a {registry} instance in {product-long-registry}. The application will use the Kafka instance to produce and consume messages and a schema stored in the {registry} instance to serialize/deserialize the messages.
 ====
 
 [#introduction]
 ====
-Welcome to the quick start for {product-long-registry} with Quarkus. In this quick start, you'll learn how to use https://quarkus.io/[Quarkus^] to produce messages to and consume messages from your Kafka instances in {product-kafka} and manage the message schemas in {product-long-registry}.
+Welcome to the quick start for {product-long-registry} with Quarkus. In this quick start, you'll learn how to manually connect an example https://quarkus.io/[Quarkus^] application to a Kafka instance in {product-long-kafka} and a {registry} instance in {product-registry}. The application will use the Kafka instance to produce and consume messages and a schema stored in the {registry} instance to serialize/deserialize the messages.
 ====
 endif::[]