docs: update quickstart (#147)

mendonk · aimurphy · web-flow · commit b2045d4e115d · 2025-08-29T11:36:19.000-04:00
* update-quickstart

* icon

* update-language-on-websocket-page

* update-language-for-finding-streaming-tenants

* Apply suggestions from code review

Co-authored-by: April I. Murphy &lt;36110273+aimurphy@users.noreply.github.com&gt;

* typo

---------

Co-authored-by: April I. Murphy &lt;36110273+aimurphy@users.noreply.github.com&gt;
diff --git a/modules/developing/pages/astream-functions.adoc b/modules/developing/pages/astream-functions.adoc
@@ -287,7 +287,7 @@ See <<controlling-your-function,Controlling your function>> for more information
 
 == Deploy functions in the {astra-ui}
 
-. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*.
+. In the {astra-ui-link}, click *Streaming tenants*.
 
 . Click the name of the tenant where you want to deploy a function.
 
@@ -393,7 +393,7 @@ Your function should output the result of processing the message.
 [#controlling-your-function]
 === Stop and start functions
 
-. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*.
+. In the {astra-ui-link}, click *Streaming tenants*.
 
 . Click the name of the tenant where you want to manage functions, and then click the *Functions* tab.
 
@@ -403,7 +403,7 @@ Your function should output the result of processing the message.
 
 Functions produce logs to help you debug them.
 
-. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*.
+. In the {astra-ui-link}, click *Streaming tenants*.
 
 . Click the name of the tenant that you want to debug, and then click the *Functions* tab.
 
@@ -415,7 +415,7 @@ If you specified a log topic when deploying your function, function logs also ou
 
 === Edit functions
 
-. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*.
+. In the {astra-ui-link}, click *Streaming tenants*.
 
 . Click the name of the tenant where your function is deployed, and then click the *Functions* tab.
 
@@ -436,7 +436,7 @@ If you need to change any other function settings, you must delete and redeploy
 Deleting a function is permanent.
 ====
 
-. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*.
+. In the {astra-ui-link}, click *Streaming tenants*.
 
 . Click the name of the tenant where you want to delete a function, and then click the *Functions* tab.
 
diff --git a/modules/developing/pages/clients/spring-produce-consume.adoc b/modules/developing/pages/clients/spring-produce-consume.adoc
@@ -176,7 +176,7 @@ Message received: Hello World
 ----
 ====
 
-. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*.
+. In the {astra-ui-link}, click *Streaming tenants*.
 
 . Click the name of your tenant, and then verify that the message appears in the specified namespace and topic.
 
diff --git a/modules/developing/pages/configure-pulsar-env.adoc b/modules/developing/pages/configure-pulsar-env.adoc
@@ -44,7 +44,7 @@ The executables in `/bin` use the configurations in `/conf` to run commands.
 Each tenant you create in {product} comes with its own custom configuration for SSO, endpoints, and so on.
 You must download the tenant configuration from {product}, and then overwrite the `./conf/client.conf` file.
 
-. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*.
+. In the {astra-ui-link}, click *Streaming tenants*.
 
 . Click the name of your tenant.
 
diff --git a/modules/developing/pages/gpt-schema-translator.adoc b/modules/developing/pages/gpt-schema-translator.adoc
@@ -23,7 +23,7 @@ The {gpt-schema-translator} is available for the {astra-db} sink connector only.
 This example uses a JSON schema for a {pulsar-short} topic, and a CQL schema for an {astra-db} table.
 The {gpt-schema-translator} generates a mapping between the two schemas that the {astra-db} sink connector can use to write data from the {pulsar-short} topic to the {astra-db} table.
 
-. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*.
+. In the {astra-ui-link}, click *Streaming tenants*.
 
 . Click the name of your tenant.
 
diff --git a/modules/developing/pages/produce-consume-astra-portal.adoc b/modules/developing/pages/produce-consume-astra-portal.adoc
@@ -9,7 +9,7 @@ The following steps will use the "Try Me" feature of the {astra-ui} to interact
 
 == Select the producer and consumer topics
 
-. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*.
+. In the {astra-ui-link}, click *Streaming tenants*.
 
 . Click the name of your tenant.
 
diff --git a/modules/developing/pages/using-curl.adoc b/modules/developing/pages/using-curl.adoc
@@ -12,7 +12,7 @@ Depending on the API you use, you need certain information to form HTTP requests
 
 == Get the tenant web service URL
 
-. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*.
+. In the {astra-ui-link}, click *Streaming tenants*.
 
 . Click the name of your tenant.
 
diff --git a/modules/developing/partials/client-variables-table.adoc b/modules/developing/partials/client-variables-table.adoc
@@ -5,7 +5,7 @@
 |`serviceUrl`
 |The URL to connect to the {pulsar-short} cluster
 a|
-. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*.
+. In the {astra-ui-link}, click *Streaming tenants*.
 . Click the name of your tenant, and then click the *Connect* tab.
 . In the *Tenant Details* section, get the *Broker Service URL*.
 
@@ -16,20 +16,20 @@ a|
 |`tenantName`
 |The name of your streaming tenant
 a|
-. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*.
-. Get the name from the *Tenants* list.
+. In the {astra-ui-link}, click *Streaming tenants*.
+. Get the name from the list of tenants.
 
 |`namespace`
 |The segmented area for certain topics in your streaming tenant
 a|
-. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*.
+. In the {astra-ui-link}, click *Streaming tenants*.
 . Click the name of your tenant, and then click the *Namespace and Topics* tab.
 . Choose the target namespace from the list of namespaces.
 
 |`topicName`
 |Topic name (not the full name)
 a|
-. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*.
+. In the {astra-ui-link}, click *Streaming tenants*.
 . Click the name of your tenant, and then click the *Namespace and Topics* tab.
 . Expand the target namespace in the list of namespaces to view the names of the topics within.
 Do _not_ use the *Full Name*.
diff --git a/modules/getting-started/pages/index.adoc b/modules/getting-started/pages/index.adoc
@@ -20,9 +20,7 @@ To learn more about the concept of tenancy, see the https://pulsar.apache.org/do
 You can create a tenant in the {astra-ui} or programmatically.
 For this quickstart, use the {astra-ui}.
 
-. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*.
-
-. Click *Create a Tenant*.
+. In the {astra-ui-link}, click **Create tenant**.
 
 . Name your streaming tenant something memorable like `my-stream-**RANDOM_UUID**`.
 All tenant names in {product} must be unique.
@@ -32,14 +30,13 @@ All tenant names in {product} must be unique.
 For this example tenant, the region doesn't really matter.
 
 . Click *Create Tenant*.
-+
-If the tenant is successfully created, you are redirected to the tenant's **Quickstart** tab.
+When the tenant is ready, it appears in the list of tenants in the {astra-ui}.
 
 == Create a namespace in your tenant
 
 Namespaces are logical groupings, such as environments or applications, for message topics within tenants.
 
-{product} automatically creates a `default` namespaces when you create a tenant.
+{product} automatically creates a `default` namespace when you create a tenant.
 You can use the default namespace or create other namespaces.
 Tenants usually have many namespaces.
 To learn more about namespaces, see the https://pulsar.apache.org/docs/concepts-messaging/#namespaces[{pulsar-short} documentation].
@@ -48,14 +45,14 @@ You can create namespaces in the {astra-ui} or programmatically.
 For this quickstart, use the {astra-ui}.
 For information about the {pulsar-short} CLI or APIs, see xref:developing:configure-pulsar-env.adoc[] and xref:developing:using-curl.adoc[].
 
-. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*.
+. In the {astra-ui-link}, click *Streaming tenants*.
 
 . Click the name of your tenant.
 
 . Click the *Namespace And Topics* tab, and then click *Create Namespace*.
 
-. Enter a namespace name, and then click *Create*.
-. Click "Create" to create the namespace.
+. Enter a namespace name, and then click *Create Namespace*.
+The new namespace appears in the *Namespaces And Topics* list.
 
 == Create a topic
 
@@ -73,7 +70,7 @@ To learn more about topics, see the https://pulsar.apache.org/docs/concepts-mess
 
 As in the previous steps, you can create topics in the {astra-ui} or programmatically.
 
-. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*.
+. In the {astra-ui-link}, click *Streaming tenants*.
 
 . Click the name of your tenant.
 
diff --git a/modules/operations/pages/astream-georeplication.adoc b/modules/operations/pages/astream-georeplication.adoc
@@ -131,7 +131,7 @@ key:[null], properties:[], content:hello-from-pulsar
 key:[null], properties:[], content:hello-from-pulsar
 ----
 
-. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*.
+. In the {astra-ui-link}, click *Streaming tenants*.
 
 . Click the name of your tenant, and then click the **Namespaces and Topics** tab.
 
diff --git a/modules/operations/pages/astream-scrape-metrics.adoc b/modules/operations/pages/astream-scrape-metrics.adoc
@@ -11,7 +11,7 @@ This doc will show you how to scrape an {product} tenant with Prometheus.
 
 == Get the configuration file from {product}
 
-. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*.
+. In the {astra-ui-link}, click *Streaming tenants*.
 
 . Click the name of your tenant, and then click the *Connect* tab.
 
diff --git a/modules/operations/pages/astream-token-gen.adoc b/modules/operations/pages/astream-token-gen.adoc
@@ -19,7 +19,7 @@ You need a {pulsar-short} JWT for actions related to {pulsar-short} tenants, nam
 
 You can generate, copy, or delete {product} {pulsar-short} tokens for each of your {product} tenants:
 
-. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*.
+. In the {astra-ui-link}, click *Streaming tenants*.
 
 . Click the name of your tenant where you want to manage tokens.
 
diff --git a/modules/operations/pages/monitoring/stream-audit-logs.adoc b/modules/operations/pages/monitoring/stream-audit-logs.adoc
@@ -12,7 +12,7 @@ To enable audit log streaming, you must do one of the following:
 Audit log streaming requires a streaming tenant in the AWS `us-east-2` region.
 You can create a new tenant with the xref:astra-streaming:getting-started:index.adoc[{product} quickstart] or use an existing {product} tenant.
 
-. In the {astra-ui-link} header, click icon:grip[name="Applications"], and then select *Streaming*.
+. In the {astra-ui-link}, click *Streaming tenants*.
 
 . Click the name of an existing tenant or create a streaming tenant in AWS `us-east-2`, and then create a namespace and topic in the tenant.
 +
