docs: JR-486: Updates quick start prerequisites to include links (#598)

* docs: JR-486: Adds link in API Designer quick start prerequisites

* docs: JR-486: Adds references to associated services in Service Registry quick start prerequisites

* docs: JR-486: Adds links in Using Quarkus with Service Registry quick start prerequisites

* docs: JR-486: Adds links in Using Quarkus with Kafka quick start prerequisites

* docs: JR-486: Adds links in Configuring Kafkacat with Kafka quick start prerequisites

* docs: JR-486: Adds links in Producing and Consuming Messages quick start prerequisites

* docs: JR-486: Adds links in Configuring Kafka Scripts quick start prerequisites

* docs: JR-486: Adds links in Using Node.js with Kafka quick start prerequisites

* docs: JR-486: Adds command-line terminal prerequisite to README.adoc

* docs: JR-486: Updates the prerequisites for the 'producing and consuming messages' doc

* docs: JR-486: Updates the prerequisites for the 'producing and consuming messages' README.adoc

* docs: JR-486: Removes redundant text from the quick-start prerequisites

* docs: JR-486: Adds command-line terminal prerequisite to README.adoc

* docs: JR-486: Updates README.adoc prerequisites to (a) standardise references to running Kafka instance, and (a) add link to doc

* docs: JR-486: Updates README.adoc prerequisites to standardise references to Red Hat account using an attribute

* docs: JR-486: Updates README.adoc to remove redundant prerequisite

* docs: JR-486: Removes references to Quarkus version number

* docs: JR-486: Implements reviewer feedback

* docs: JR-486: Updates references to later Maven 3 versions

* docs: JR-486: Removes '.x' from Node.js version

Author: bredamc

docs/api-designer/getting-started-api-designer/quickstart.yml

@@ -16,7 +16,7 @@ spec:
     data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48c3ZnIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgdmlld0JveD0iMCAwIDM4IDM4Ij48ZGVmcz48c3R5bGU+LmR7c3Ryb2tlOiMwMDA7fS5kLC5le2ZpbGw6bm9uZTtzdHJva2UtbGluZWNhcDpyb3VuZDtzdHJva2UtbGluZWpvaW46cm91bmQ7c3Ryb2tlLXdpZHRoOjEuMjVweDt9LmV7c3Ryb2tlOnJlZDt9LmZ7ZmlsbDojZmZmO308L3N0eWxlPjwvZGVmcz48ZyBpZD0iYSI+PGc+PHJlY3QgY2xhc3M9ImYiIHg9IjEuNjIiIHk9IjEuODEiIHdpZHRoPSIzNC43NSIgaGVpZ2h0PSIzNC43NSIgcng9IjguMzgiIHJ5PSI4LjM4Ii8+PHBhdGggZD0iTTI4LDIuNDNjNC4yNywwLDcuNzUsMy40OCw3Ljc1LDcuNzVWMjguMThjMCw0LjI3LTMuNDgsNy43NS03Ljc1LDcuNzVIMTBjLTQuMjcsMC03Ljc1LTMuNDgtNy43NS03Ljc1VjEwLjE4YzAtNC4yNywzLjQ4LTcuNzUsNy43NS03Ljc1SDI4bTAtMS4yNUgxMEM1LjAzLDEuMTgsMSw1LjIxLDEsMTAuMThWMjguMThjMCw0Ljk3LDQuMDMsOSw5LDlIMjhjNC45NywwLDktNC4wMyw5LTlWMTAuMThjMC00Ljk3LTQuMDMtOS05LTloMFoiLz48L2c+PC9nPjxnIGlkPSJiIj48Zz48cG9seWxpbmUgY2xhc3M9ImUiIHBvaW50cz0iMjAgMjcuMTUgMjQuMjggMjIuMjUgMjguNjMgMTcuMTcgMjcuODUgMTYuNDkgMjcuMDcgMTUuODIgMjIuNzEgMjAuOTEgMTguMzUgMjUuOTkiLz48cGF0aCBkPSJNMjIuODksMTMuOTdjLjEyLDAsLjI1LS4wNSwuMzQtLjE0bDEuNDEtMS40MWguOTNjLjU3LDIuMyw0LjAxLDEuOTEsNC4wMi0uNDktLjAxLTIuNC0zLjQ2LTIuNzktNC4wMi0uNDloLTEuMTRjLS4xMywwLS4yNSwuMDUtLjM0LC4xNGwtMS41NiwxLjU2Yy0uMzEsLjI5LS4wNywuODUsLjM0LC44M1ptNC42Ny0zLjExYzEuNDEsLjAyLDEuNDEsMi4xMiwwLDIuMTQtMS40MS0uMDItMS40MS0yLjEyLDAtMi4xNFoiLz48cGF0aCBkPSJNMTAuNDMsMTMuOTdjLjk2LDAsMS43Ni0uNjcsMS45OC0xLjU2aC45M2wxLjQxLDEuNDFjLjQ1LC40NSwxLjE0LS4yNCwuNjktLjY5bC0xLjU2LTEuNTZjLS4wOS0uMDktLjIyLS4xNC0uMzQtLjE0aC0xLjE0Yy0uNTctMi4zLTQuMDEtMS45MS00LjAyLC40OSwwLDEuMTMsLjkyLDIuMDQsMi4wNCwyLjA0Wm0wLTMuMTFjMS40MSwuMDIsMS40MSwyLjEyLDAsMi4xNC0xLjQxLS4wMi0xLjQxLTIuMTIsMC0yLjE0WiIvPjxwYXRoIGQ9Ik04Ljg4LDIwLjJoMy4xMWMuMjcsMCwuNDktLjIyLC40OS0uNDl2LTEuMDdoMS44NWMuNjQsMCwuNjQtLjk3LDAtLjk3aC0xLjg1di0xLjA3YzAtLjI3LS4yMi0uNDktLjQ5LS40OWgtMy4xMWMtLjI3LDAtLjQ5LC4yMi0uNDksLjQ5djMuMTFjMCwuMjcsLjIyLC40OSwuNDksLjQ5Wm0uNDktMy4xMWgyLjE0djIuMTRoLTIuMTR2LTIuMTRaIi8+PHBhdGggZD0iTTE0Ljc2LDIyLjQ4bC0xLjQxLDEuNDFoLS45M2MtLjU3LTIuMy00LjAxLTEuOTEtNC4wMiwuNDksLjAxLDIuNCwzLjQ2LDIuNzksNC4wMiwuNDloMS4xNGMuMTMsMCwuMjUtLjA1LC4zNC0uMTRsMS41Ni0xLjU2Yy40NS0uNDQtLjI1LTEuMTQtLjY5LS42OVptLTQuMzMsMi45N2MtMS40MS0uMDItMS40MS0yLjEyLDAtMi4xNCwxLjQxLC4wMiwxLjQxLDIuMTIsMCwyLjE0WiIvPjxwb2x5bGluZSBjbGFzcz0iZCIgcG9pbnRzPSIxOSAyMS4xNSAxNy41IDIxLjE1IDE2IDIxLjE1IDE2IDE5LjY1IDE2IDE4LjE1IDE2IDE2LjY1IDE2IDE1LjE1IDE3LjUgMTUuMTUgMTkgMTUuMTUgMjAuNSAxNS4xNSAyMiAxNS4xNSAyMiAxNi42NSAyMiAxOC4xNSIvPjxwb2x5bGluZSBjbGFzcz0iZSIgcG9pbnRzPSIxOC4yMyAyNi4xNSAxOC4xMiAyNy4xMyAxOCAyOC4xIDE4LjkgMjcuNzEgMTkuOCAyNy4zMyIvPjwvZz48L2c+PGcgaWQ9ImMiLz48L3N2Zz4=
   description: !snippet README.adoc#description
   prerequisites:
-    - A running Service Registry instance (required only if you want to export to Service Registry, see the Getting started with Service Registry quick start)
+    - A running Service Registry instance (required only if you want to export to Service Registry, see <a href="https://console.redhat.com/application-services/learning-resources?quickstart=getting-started-service-registry">Getting started with Service Registry</a>)
   introduction: !snippet README.adoc#introduction
   tasks:
     - !snippet/proc README.adoc#proc-creating-api-design

docs/connectors/rhoas-cli-getting-started-connectors/README.adoc

@@ -103,7 +103,7 @@ Use this guide to complete the following tasks:
 
 .Prerequisites
 
-* You have a Red Hat account.
+* You have a {org-name} account.
 * You've installed the latest version of the `rhoas` CLI. See {base-url}{installation-guide-url-cli}[Installing and configuring the rhoas CLI^].
 * You've completed the following tasks:
 +
@@ -113,42 +113,42 @@ Use this guide to complete the following tasks:
 [source,subs="+quotes"]
 +
 ----
-$ rhoas kafka create --name=my-kafka-instance 
+$ rhoas kafka create --name=my-kafka-instance
 ----
 
 ** Verify that the Kafka instance is in the *Ready* state.
 +
 [source,subs="+quotes"]
 ----
-$ rhoas context status kafka 
+$ rhoas context status kafka
 ----
 
 ** Create a service account and copy the service account ID and secret. You must use a service account to connect and authenticate your {product-connectors} instances with your Kafka instance.
 +
 [source,subs="+quotes"]
 ----
-$ rhoas service-account create --file-format=json --short-description=test-service-account 
+$ rhoas service-account create --file-format=json --short-description=test-service-account
 ----
 
 ** For your Kafka instance, set the permissions for the service account to enable {connectors} instances (that are configured with the service account credentials) to produce and consume messages in any topic in the Kafka instance.
 +
 [source,subs="+quotes"]
 ----
-$ rhoas kafka acl grant-access --producer --consumer --service-account=<service-acct-id> --topic all --group all 
+$ rhoas kafka acl grant-access --producer --consumer --service-account=<service-acct-id> --topic all --group all
 ----
 
 ** Create a Kafka topic named `test-topic`. The Kafka topic stores messages sent by producers (data sources) and makes them available to consumers (data sinks).
 +
 [source,subs="+quotes"]
 ----
-$ rhoas kafka topic create --name=test-topic 
+$ rhoas kafka topic create --name=test-topic
 ----
 
 [id="proc-create-connector-namespace_{context}"]
 == Creating a namespace to host your {connectors} instances
 [role="_abstract"]
 
-A {connectors} namespace hosts your {connectors} instances. 
+A {connectors} namespace hosts your {connectors} instances.
 
 The namespace that you use depends on your OpenShift Dedicated environment.
 
@@ -187,11 +187,11 @@ $ rhoas connector namespace list
 == Building connector configuration files
 
 [role="_abstract"]
-Before you can create a {connectors} instance, you must build a configuration file that is based on a supported connector type that is listed in the {product-connectors} catalog. 
+Before you can create a {connectors} instance, you must build a configuration file that is based on a supported connector type that is listed in the {product-connectors} catalog.
 
 For this example, you want to create two types of connectors: a data generator (a source connector) and an HTTP sink connector.
 
-You must build a configuration file for each connector type that you want to create. When you build a configuration file, the default file name is `connector.json`. Optionally, you can specify a different configuration file name. 
+You must build a configuration file for each connector type that you want to create. When you build a configuration file, the default file name is `connector.json`. Optionally, you can specify a different configuration file name.
 
 .Prerequisites
 
@@ -220,9 +220,9 @@ $ rhoas connector type list --limit=100
 // +
 // [source,subs="+quotes"]
 // ----
-// rhoas connector type list --limit=70 --search=%sink% 
+// rhoas connector type list --limit=70 --search=%sink%
 // ----
-// 
+//
 // .. Filter the list to show only source connectors:
 // +
 // [source,subs="+quotes"]
@@ -300,11 +300,11 @@ $ rhoas connector build --name=test-http --type=http_sink_0.1 --output-file=test
 
 .. For *Format*, press *ENTER* to accept the default (`application/octet-stream`).
 
-.. For *Error handling method*, select `stop`. 
+.. For *Error handling method*, select `stop`.
 
 .. For *Method*, accept the default (`POST`).
 
-.. For *URL*, paste your unique URL that you copied from the https://webhook.site[Webhook.site^] page. 
+.. For *URL*, paste your unique URL that you copied from the https://webhook.site[Webhook.site^] page.
 
 .. For *Topic Names*, type `test-topic`.
 
@@ -343,7 +343,7 @@ For this example, you create two {connectors} instances: a data generator source
 +
 [source,subs="+quotes"]
 ----
-$ rhoas connector create --file=test-generator.json 
+$ rhoas connector create --file=test-generator.json
 ----
 
 . Answer the prompts for details about the {connectors} instance.
@@ -353,10 +353,10 @@ $ rhoas connector create --file=test-generator.json
 .. For *Service Account Client ID*, type or paste your ID.
 
 .. For *Service Account Client Secret*, type or paste your secret.
-+ 
++
 A message states "Successfully created the {connectors} instance".
 
-. Wait until the status of the {connectors} instance is *Ready*. 
+. Wait until the status of the {connectors} instance is *Ready*.
 +
 To check the status:
 +
@@ -376,7 +376,7 @@ $ rhoas kafka topic consume --name=test-topic --partition=0 --wait
 +
 [source,subs="+quotes"]
 ----
-$ rhoas connector create --file=test-http.json 
+$ rhoas connector create --file=test-http.json
 ----
 
 . Answer the prompts for details about the {connectors} instance.
@@ -389,7 +389,7 @@ $ rhoas connector create --file=test-http.json
 +
 A message states "Successfully created the {connectors} instance".
 
-. Wait until the status of the {connectors} instance is *Ready*. 
+. Wait until the status of the {connectors} instance is *Ready*.
 +
 To check the status:
 +
@@ -417,4 +417,4 @@ For more information about the `rhoas connector` commands that you can use to ma
 * {base-url-cli}{command-ref-url-cli}[_CLI command reference (rhoas)_^]
 
 ifdef::parent-context[:context: {parent-context}]
-ifndef::parent-context[:!context:]
+ifndef::parent-context[:!context:]

docs/kafka/access-mgmt-kafka/README.adoc

@@ -243,7 +243,7 @@ https://kafka.apache.org/documentation/#security_authz_primitives[Authorization
 In {product-long-kafka}, you can create Access Control Lists (ACLs) in your Kafka instances and set permissions for how other user accounts or service accounts can interact with an instance and its resources. You can manage access for only the Kafka instances that you create or for the instances that the owner has enabled you to access and alter.
 
 .Prerequisites
-* You've created a Kafka instance and the instance is in the *Ready* state.
+* You have a running Kafka instance in {product-kafka} (see {base-url}{getting-started-url-kafka}[Getting started with {product-long-kafka}^]).
 * The user account or service account that you're setting permissions for has been created in the organization.
 
 .Procedure

docs/kafka/consumer-configuration-kafka/README.adoc

@@ -256,7 +256,7 @@ If you're using Kafka scripts, you can use the `kafka-consumer-groups.sh` tool t
 
 
 .Prerequisites
-* You've created a Kafka instance with at least one Kafka topic in {product-kafka}.
+* You have a running Kafka instance with at least one Kafka topic in {product-kafka} (see {base-url}{getting-started-url-kafka}[Getting started with {product-long-kafka}^]).
 * Consumer client applications connected to the Kafka instance have a consumer group ID.
 
 .Procedure

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

@@ -96,7 +96,7 @@ As a developer of applications and services, you can use {product-long-kafka} to
 
 ifndef::community[]
 .Prerequisites
-* You have a Red Hat account.
+* You have a {org-name} account.
 //* You have a subscription to {product-long-kafka}. For more information about signing up, see *<@SME: Where to link?>*.
 endif::[]
 

docs/kafka/kafka-bin-scripts-kafka/README.adoc

@@ -102,7 +102,8 @@ With the scripts, you can produce and consume messages using your Kafka instance
 NOTE: The command examples in this quick start show how to use the Kafka scripts on Linux and macOS. If you're using Windows, use the Windows versions of the scripts. For example, instead of the `__<Kafka-distribution-dir>__/bin/kafka-console-producer.sh` script, use the `__<Kafka-distribution-dir>__\bin\windows\kafka-console-producer.bat` script.
 
 .Prerequisites
-* You have a running Kafka instance in {product-kafka}.
+* You have a running Kafka instance in {product-kafka} (see {base-url}{getting-started-url-kafka}[Getting started with {product-long-kafka}^]).
+* You have a command-line terminal application.
 * https://adoptopenjdk.net/[JDK^] 11 or later is installed. (The latest LTS version of OpenJDK is recommended.)
 * You've downloaded the latest supported binary version of the https://kafka.apache.org/downloads[Apache Kafka distribution^]. You can check your Kafka version using the following command:
 +
@@ -169,7 +170,7 @@ In this task, you use the `kafka-console-producer` script to produce messages to
 
 .Prerequisites
 
-* You have a running Kafka instance in {product-long-kafka}.
+* You have a running Kafka instance in {product-long-kafka} (see {base-url}{getting-started-url-kafka}[Getting started with {product-long-kafka}^]).
 * You have the bootstrap server endpoint for your Kafka instance. To get the server endpoint, select your Kafka instance in the {product-long-kafka} web console, select the options icon (three vertical dots), and click *Connection*.
 * You've created the `{property-file-name}` file to store your service account credentials.
 

docs/kafka/kafka-bin-scripts-kafka/quickstart.yml

@@ -15,10 +15,10 @@ spec:
     data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4KPCEtLSBHZW5lcmF0b3I6IEFkb2JlIElsbHVzdHJhdG9yIDI1LjIuMCwgU1ZHIEV4cG9ydCBQbHVnLUluIC4gU1ZHIFZlcnNpb246IDYuMDAgQnVpbGQgMCkgIC0tPgo8c3ZnIHZlcnNpb249IjEuMSIgaWQ9IkxheWVyXzEiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgeG1sbnM6eGxpbms9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkveGxpbmsiIHg9IjBweCIgeT0iMHB4IgoJIHZpZXdCb3g9IjAgMCAzNyAzNyIgc3R5bGU9ImVuYWJsZS1iYWNrZ3JvdW5kOm5ldyAwIDAgMzcgMzc7IiB4bWw6c3BhY2U9InByZXNlcnZlIj4KPHN0eWxlIHR5cGU9InRleHQvY3NzIj4KCS5zdDB7ZmlsbDojRUUwMDAwO30KCS5zdDF7ZmlsbDojRkZGRkZGO30KPC9zdHlsZT4KPGc+Cgk8cGF0aCBkPSJNMjcuNSwwLjVoLTE4Yy00Ljk3LDAtOSw0LjAzLTksOXYxOGMwLDQuOTcsNC4wMyw5LDksOWgxOGM0Ljk3LDAsOS00LjAzLDktOXYtMThDMzYuNSw0LjUzLDMyLjQ3LDAuNSwyNy41LDAuNUwyNy41LDAuNXoiCgkJLz4KCTxwYXRoIGNsYXNzPSJzdDAiIGQ9Ik0xNi41LDE4LjEyYy0xLjcyLDAtMy4xMi0xLjQtMy4xMi0zLjEyczEuNC0zLjEyLDMuMTItMy4xMnMzLjEyLDEuNCwzLjEyLDMuMTJTMTguMjIsMTguMTIsMTYuNSwxOC4xMnoKCQkgTTE2LjUsMTMuMTJjLTEuMDMsMC0xLjg4LDAuODQtMS44OCwxLjg4czAuODQsMS44OCwxLjg4LDEuODhzMS44OC0wLjg0LDEuODgtMS44OFMxNy41MywxMy4xMiwxNi41LDEzLjEyeiIvPgoJPHBhdGggY2xhc3M9InN0MSIgZD0iTTEyLjk0LDExLjA2bC0yLTJjLTAuMDgtMC4wOC0wLjE4LTAuMTMtMC4yOS0wLjE1Yy0wLjAzLTAuMDEtMC4wNS0wLjAxLTAuMDctMC4wMQoJCWMtMC4xMS0wLjAxLTAuMjItMC4wMS0wLjMyLDAuMDNjMCwwLDAsMCwwLDBjLTAuMDcsMC4wMy0wLjEzLDAuMDctMC4xOCwwLjEyYy0wLjAxLDAuMDEtMC4wMSwwLjAxLTAuMDIsMC4wMWwtMiwyCgkJYy0wLjI0LDAuMjQtMC4yNCwwLjY0LDAsMC44OGMwLjEyLDAuMTIsMC4yOCwwLjE4LDAuNDQsMC4xOHMwLjMyLTAuMDYsMC40NC0wLjE4bDAuOTMtMC45M1YyMi41YzAsMC4zNSwwLjI4LDAuNjIsMC42MiwwLjYyCgkJczAuNjItMC4yOCwwLjYyLTAuNjJWMTEuMDFsMC45MywwLjkzYzAuMjQsMC4yNCwwLjY0LDAuMjQsMC44OCwwQzEzLjE5LDExLjcsMTMuMTksMTEuMywxMi45NCwxMS4wNnoiLz4KCTxwYXRoIGNsYXNzPSJzdDAiIGQ9Ik0yMi41LDE4LjEyYy0wLjM0LDAtMC42Mi0wLjI4LTAuNjItMC42MnYtNWMwLTAuMzUsMC4yOC0wLjYyLDAuNjItMC42MnMwLjYyLDAuMjgsMC42MiwwLjYydjUKCQlDMjMuMTIsMTcuODUsMjIuODQsMTguMTIsMjIuNSwxOC4xMnoiLz4KCTxwYXRoIGNsYXNzPSJzdDAiIGQ9Ik0yMC41LDI1LjEyYy0xLjcyLDAtMy4xMi0xLjQtMy4xMi0zLjEyczEuNC0zLjEyLDMuMTItMy4xMnMzLjEyLDEuNCwzLjEyLDMuMTJTMjIuMjIsMjUuMTIsMjAuNSwyNS4xMnoKCQkgTTIwLjUsMjAuMTJjLTEuMDMsMC0xLjg4LDAuODQtMS44OCwxLjg4czAuODQsMS44OCwxLjg4LDEuODhzMS44OC0wLjg0LDEuODgtMS44OFMyMS41MywyMC4xMiwyMC41LDIwLjEyeiIvPgoJPHBhdGggY2xhc3M9InN0MSIgZD0iTTI4Ljk0LDI1LjA2Yy0wLjI0LTAuMjQtMC42NC0wLjI0LTAuODgsMGwtMC45MywwLjkzVjEyLjVjMC0wLjM1LTAuMjgtMC42Mi0wLjYyLTAuNjJzLTAuNjIsMC4yOC0wLjYyLDAuNjIKCQl2MTMuNDlsLTAuOTMtMC45M2MtMC4yNC0wLjI0LTAuNjQtMC4yNC0wLjg4LDBjLTAuMjQsMC4yNC0wLjI0LDAuNjQsMCwwLjg4bDIsMmMwLjA2LDAuMDYsMC4xMywwLjExLDAuMjEsMC4xNAoJCWMwLjA4LDAuMDMsMC4xNiwwLjA1LDAuMjQsMC4wNWMwLjA4LDAsMC4xNi0wLjAyLDAuMjQtMC4wNWMwLDAsMCwwLDAsMGMwLjA3LTAuMDMsMC4xMy0wLjA3LDAuMTgtMC4xMgoJCWMwLjAxLTAuMDEsMC4wMS0wLjAxLDAuMDItMC4wMWwyLTJDMjkuMTksMjUuNywyOS4xOSwyNS4zLDI4Ljk0LDI1LjA2eiIvPgoJPHBhdGggY2xhc3M9InN0MCIgZD0iTTE0LjUsMjUuMTJjLTAuMzQsMC0wLjYyLTAuMjgtMC42Mi0wLjYydi01YzAtMC4zNSwwLjI4LTAuNjIsMC42Mi0wLjYyczAuNjIsMC4yOCwwLjYyLDAuNjJ2NQoJCUMxNS4xMiwyNC44NSwxNC44NCwyNS4xMiwxNC41LDI1LjEyeiIvPgoJPHBhdGggY2xhc3M9InN0MCIgZD0iTTI2LjUsMTguMTJjLTAuMzQsMC0wLjYyLTAuMjgtMC42Mi0wLjYydi01YzAtMC4zNSwwLjI4LTAuNjIsMC42Mi0wLjYyczAuNjIsMC4yOCwwLjYyLDAuNjJ2NQoJCUMyNy4xMiwxNy44NSwyNi44NCwxOC4xMiwyNi41LDE4LjEyeiIvPgoJPHBhdGggY2xhc3M9InN0MCIgZD0iTTEwLjUsMjUuMTJjLTAuMzQsMC0wLjYyLTAuMjgtMC42Mi0wLjYydi01YzAtMC4zNSwwLjI4LTAuNjIsMC42Mi0wLjYyczAuNjIsMC4yOCwwLjYyLDAuNjJ2NQoJCUMxMS4xMiwyNC44NSwxMC44NCwyNS4xMiwxMC41LDI1LjEyeiIvPgo8L2c+Cjwvc3ZnPgo=
   description: !snippet README.adoc#description
   prerequisites:
-    - A running Kafka instance (see the Getting Started quick start)
+    - A running Kafka instance (see <a href="https://console.redhat.com/application-services/learning-resources?quickstart=getting-started">Getting started with OpenShift Streams for Apache Kafka</a>)
     - The latest supported binary version of the Apache Kafka distribution
     - A command-line terminal application
-    - JDK 11 or later (the latest LTS version of OpenJDK is recommended)     
+    - JDK 11 or later (the latest LTS version of OpenJDK is recommended)
   introduction: !snippet README.adoc#introduction
   tasks:
     - !snippet/proc README.adoc#proc-configuring-kafka-bin-scripts

docs/kafka/kafka-instance-settings/README.adoc

@@ -111,7 +111,7 @@ rhoas kafka update --reauthentication false
 For a list of Kafka instance settings that you can update using the CLI, see the `rhoas kafka update` entry in the {base-url-cli}{command-ref-url-cli}[CLI command reference (rhoas)^].
 
 .Prerequisites
-* You have created a Kafka instance. To learn how to do this, see {base-url}{getting-started-url-kafka}[Getting started with {product-long-kafka}^].
+* You have a running Kafka instance with at least one Kafka topic in {product-kafka} (see {base-url}{getting-started-url-kafka}[Getting started with {product-long-kafka}^]).
 
 .Procedure
 . In the {product-kafka} {service-url-kafka}[web console^], click *Kafka Instances* and select a Kafka instance.
@@ -134,7 +134,7 @@ You can edit the following Kafka instance settings in {product-long-kafka}.
 Connection re-authentication::
 +
 --
-When a client connects to a Kafka instance, the session lasts for five minutes. 
+When a client connects to a Kafka instance, the session lasts for five minutes.
 At that point, the client must reauthenticate to stay connected.
 Many Kafka clients automatically reauthenticate to remain connected,
 but some Kafka clients do not.
@@ -157,4 +157,4 @@ You could also contact Red Hat Support for assistance.
 endif::[]
 
 NOTE: Disabling connection re-authentication will restart your Kafka instance.
---
+--

docs/kafka/kcat-kafka/README.adoc

@@ -98,7 +98,8 @@ NOTE: Kcat is an open source community tool. Kcat is not a part of {product-kafk
 endif::[]
 
 .Prerequisites
-* You have a running Kafka instance in {product-kafka}.
+* You have a running Kafka instance in {product-kafka} (see {base-url}{getting-started-url-kafka}[Getting started with {product-long-kafka}^]).
+* You have a command-line terminal application.
 * https://adoptopenjdk.net/[JDK^] 11 or later is installed. (The latest LTS version of OpenJDK is recommended.)
 * You've installed the latest supported version of https://github.com/edenhill/kcat[Kcat^] for your operating system. To verify your Kcat version, enter the following command:
 +
@@ -107,7 +108,7 @@ endif::[]
 $ kcat -V
 ----
 +
-You see output like the following example:
+You see output similar to the following example:
 +
 [source]
 ----
@@ -167,7 +168,7 @@ You can use Kcat to produce messages to Kafka topics in several ways, such as re
 
 .Prerequisites
 * Kcat is installed.
-* You have a running Kafka instance in {product-long-kafka}.
+* You have a running Kafka instance in {product-long-kafka} (see {base-url}{getting-started-url-kafka}[Getting started with {product-long-kafka}^]).
 * You have a topic in your Kafka instance that you can use to produce and consume messages.
 * You've set the Kafka bootstrap server endpoint and your service account credentials as environment variables.
 
@@ -218,7 +219,7 @@ You can also use Kcat to consume messages from Kafka topics. In this task, you u
 
 .Prerequisites
 * Kcat is installed.
-* You have a running Kafka instance in {product-long-kafka}.
+* You have a running Kafka instance in {product-long-kafka} (see {base-url}{getting-started-url-kafka}[Getting started with {product-long-kafka}^]).
 * You used Kcat to produce example messages to a topic in your Kafka instance.
 
 .Procedure