docs: Update Quarkus and Node.js quick starts to better describe manual connection use case (#537)

* Update quick starts to better describe the manual connection use case that they cover

* Minor tweaks

* Update links to relfect new titles

* SME feedback

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[Using Quarkus applications with Kafka instances in {product-long-kafka}]
+* link:./docs/kafka/quarkus-kafka[Manually connecting Quarkus applications to 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[Using Node.js applications with Kafka instances in {product-long-kafka}]
+* link:./docs/kafka/nodejs-kafka[Manually connecting Node.js applications to 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

@@ -345,12 +345,12 @@ endif::[]
 [role="_additional-resources"]
 == Additional resources
 * https://console.redhat.com/application-services/streams/overview[Purchase a subscription to {product-long-kafka}]
-* https://access.redhat.com/documentation/en-us/red_hat_openshift_streams_for_apache_kafka/1/guide/7d28aec8-e146-44db-a4a5-fafc1f426ca5[_Configuring topics in {product-long-kafka}_^]
-* {base-url}{getting-started-rhoas-cli-url-kafka}[_Getting started with the `rhoas` CLI for {product-long-kafka}_^]
-* {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}[_Using Quarkus applications with Kafka instances in {product-long-kafka}_^]
+* https://access.redhat.com/documentation/en-us/red_hat_openshift_streams_for_apache_kafka/1/guide/7d28aec8-e146-44db-a4a5-fafc1f426ca5[Configuring topics in {product-long-kafka}^]
+* {base-url}{getting-started-rhoas-cli-url-kafka}[Getting started with the rhoas CLI for {product-long-kafka}^]
+* {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}^]
 
 ifdef::qs[]
 [#conclusion]

docs/kafka/nodejs-kafka/README.adoc

@@ -74,14 +74,18 @@ END GENERATED ATTRIBUTES
 ////
 
 [id="chap-using-nodejs"]
-= Using Node.js applications with Kafka instances in {product-long-kafka}
+= Manually connecting Node.js applications to 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.
+
+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^].
+
 .Prerequisites
 ifndef::community[]
 * You have a Red Hat account.
@@ -91,22 +95,20 @@ endif::[]
 * You have an IDE such as https://www.jetbrains.com/idea/download/[IntelliJ IDEA^], https://www.eclipse.org/downloads/[Eclipse^], or https://code.visualstudio.com/Download[VSCode^].
 * https://nodejs.org/en/download/[Node.js 14^] is installed. The https://github.com/blizzard/node-rdkafka[node-rdkafka^] client can't run on later versions.
 
-[NOTE]
-====
-The example Node.js application in this quick start uses the https://kafka.js.org/[KafkaJS^] client by default. If you want to use the https://github.com/blizzard/node-rdkafka[node-rdkafka^] client, you must install some development tools locally on your computer, or use Docker to run a specified container image and configure a development environment. To learn more, see the https://github.com/nodeshift-starters/reactive-example/tree/node-rdkafka#node-rdkafka-and-kafkajs[documentation] for the example Node.js application.
-====
+NOTE: The example Node.js application in this quick start uses the https://kafka.js.org/[KafkaJS^] client by default. If you want to use the https://github.com/blizzard/node-rdkafka[node-rdkafka^] client, you must install some development tools locally on your computer or use a container runtime such as Podman or Docker to run a specified container image and configure a development environment. To learn more, see the https://github.com/nodeshift-starters/reactive-example/tree/node-rdkafka#node-rdkafka-and-kafkajs[documentation] for the example Node.js application.
+
 
 // Condition out QS-only content so that it doesn't appear in docs.
 // All QS anchor IDs must be in this alternate anchor ID format `[#anchor-id]` because the ascii splitter relies on the other format `[id="anchor-id"]` to generate module files.
 ifdef::qs[]
 [#description]
 ====
-Learn how to use Node.js applications to produce and consume messages using a Kafka instance in {product-long-kafka}.
+Learn how to manually connect a Node.js application to a Kafka instance in {product-long-kafka} and then produce and consume messages.
 ====
 
 [#introduction]
 ====
-Welcome to the quick start for {product-long-kafka} with Node.js. In this quick start, you'll learn how to use the https://nodejs.org/en/about/[Node.js^] runtime to produce messages to and consume messages from your Kafka instances in {product-kafka}.
+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.
 ====
 endif::[]
 

docs/kafka/quarkus-kafka/README.adoc

@@ -74,14 +74,18 @@ END GENERATED ATTRIBUTES
 ////
 
 [id="chap-using-quarkus"]
-= Using Quarkus applications with Kafka instances in {product-long-kafka}
+= Manually connecting Quarkus applications to 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.
+
+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^].
+
 .Prerequisites
 ifndef::community[]
 * You have a Red Hat account.
@@ -97,20 +101,20 @@ endif::[]
 ifdef::qs[]
 [#description]
 ====
-Learn how to use Quarkus applications to produce messages to and consume messages from a Kafka instance in {product-long-kafka}.
+Learn how to manually connect a Quarkus application to a Kafka instance in {product-long-kafka} and then produce and consume messages.
 ====
 
 [#introduction]
 ====
-Welcome to the quick start for {product-long-kafka} 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}.
+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.
 ====
 endif::[]
 
 [id="proc-importing-quarkus-sample-code_{context}"]
 == Importing the Quarkus sample code
 
 [role="_abstract"]
-For this quick start, you'll use the Quarkus sample code from the {product-kafka} {samples-git-repo}[Guides and Samples^] repository in GitHub. After you understand the concepts and tasks in this quick start, you can use your own Quarkus applications with {product-kafka} in the same way.
+For this quick start, you'll use the Quarkus sample code from the {product-kafka} {samples-git-repo}[Guides and Samples^] repository in GitHub.
 
 .Procedure
 . On the command line, clone the {product-kafka} {samples-git-repo}[Guides and Samples^] repository from GitHub.
@@ -238,7 +242,7 @@ endif::[]
 ifdef::qs[]
 [#conclusion]
 ====
-Congratulations! You successfully completed the {product-kafka} Quarkus quick start, and are now ready to use your own Quarkus applications with {product-kafka}.
+Congratulations! You successfully completed the {product-kafka} Quarkus quick start, and are now ready to connect your own Quarkus applications to {product-kafka}.
 ====
 endif::[]