From b88d7b2b20e8dc1b66cce6a3458e18af28d760da Mon Sep 17 00:00:00 2001
From: April M <36110273+aimurphy@users.noreply.github.com>
Date: Fri, 19 Jun 2026 14:32:01 -0700
Subject: [PATCH] module segment in xrefs

---
 .../ROOT/pages/astream-subscriptions-exclusive.adoc  |  8 ++++----
 .../ROOT/pages/astream-subscriptions-failover.adoc   | 10 +++++-----
 .../ROOT/pages/astream-subscriptions-keyshared.adoc  | 12 ++++++------
 modules/ROOT/pages/astream-subscriptions-shared.adoc | 10 +++++-----
 modules/ROOT/pages/astream-subscriptions.adoc        | 11 +++++------
 modules/developing/pages/astream-functions.adoc      |  2 +-
 modules/developing/pages/clients/index.adoc          | 12 ++++++------
 modules/developing/pages/configure-pulsar-env.adoc   |  2 +-
 .../pages/produce-consume-astra-portal.adoc          |  4 ++--
 .../pages/produce-consume-pulsar-client.adoc         |  4 ++--
 modules/operations/pages/astream-pricing.adoc        |  4 ++--
 modules/operations/pages/astream-scrape-metrics.adoc |  2 +-
 modules/operations/pages/monitoring/index.adoc       | 10 +++++-----
 modules/operations/pages/monitoring/integration.adoc |  9 ++++-----
 modules/operations/pages/monitoring/metrics.adoc     |  8 ++++----
 .../pages/monitoring/namespace-dashboard.adoc        |  4 ++--
 modules/operations/pages/monitoring/new-relic.adoc   | 10 +++++-----
 .../pages/monitoring/overview-dashboard.adoc         |  4 ++--
 .../operations/pages/monitoring/topic-dashboard.adoc |  4 ++--
 19 files changed, 64 insertions(+), 66 deletions(-)

diff --git a/modules/ROOT/pages/astream-subscriptions-exclusive.adoc b/modules/ROOT/pages/astream-subscriptions-exclusive.adoc
index ca9e020..cbea701 100644
--- a/modules/ROOT/pages/astream-subscriptions-exclusive.adoc
+++ b/modules/ROOT/pages/astream-subscriptions-exclusive.adoc
@@ -89,7 +89,7 @@ Caused by: org.apache.pulsar.client.api.PulsarClientException$ConsumerBusyExcept
 
 == See also
 
-* xref:astream-subscriptions.adoc[]
-* xref:astream-subscriptions-shared.adoc[]
-* xref:astream-subscriptions-failover.adoc[]
-* xref:astream-subscriptions-keyshared.adoc[]
+* xref:ROOT:astream-subscriptions.adoc[]
+* xref:ROOT:astream-subscriptions-shared.adoc[]
+* xref:ROOT:astream-subscriptions-failover.adoc[]
+* xref:ROOT:astream-subscriptions-keyshared.adoc[]
\ No newline at end of file
diff --git a/modules/ROOT/pages/astream-subscriptions-failover.adoc b/modules/ROOT/pages/astream-subscriptions-failover.adoc
index f131feb..80c39fd 100644
--- a/modules/ROOT/pages/astream-subscriptions-failover.adoc
+++ b/modules/ROOT/pages/astream-subscriptions-failover.adoc
@@ -5,7 +5,7 @@
 
 _Subscriptions_ in {pulsar-reg} describe which consumers are consuming data from a topic and how they want to consume that data.
 
-If an xref:astream-subscriptions-exclusive.adoc[exclusive] consumer fails, the topic backlog accumulates stale, unacknowledged messages.
+If an xref:ROOT:astream-subscriptions-exclusive.adoc[exclusive] consumer fails, the topic backlog accumulates stale, unacknowledged messages.
 {pulsar-short} solves this problem with failover subscriptions.
 In _failover subscriptions_, {pulsar-short} designates one primary consumer and multiple standby consumers.
 If the primary consumer disconnects, the standby consumers begin consuming the subsequent unacknowledged messages.
@@ -78,7 +78,7 @@ To test them, you can progressively end each `SimplePulsarConsumer` process, and
 
 == See also
 
-* xref:astream-subscriptions.adoc[]
-* xref:astream-subscriptions-exclusive.adoc[]
-* xref:astream-subscriptions-shared.adoc[]
-* xref:astream-subscriptions-keyshared.adoc[]
\ No newline at end of file
+* xref:ROOT:astream-subscriptions.adoc[]
+* xref:ROOT:astream-subscriptions-exclusive.adoc[]
+* xref:ROOT:astream-subscriptions-shared.adoc[]
+* xref:ROOT:astream-subscriptions-keyshared.adoc[]
\ No newline at end of file
diff --git a/modules/ROOT/pages/astream-subscriptions-keyshared.adoc b/modules/ROOT/pages/astream-subscriptions-keyshared.adoc
index 2d37589..17e99ac 100644
--- a/modules/ROOT/pages/astream-subscriptions-keyshared.adoc
+++ b/modules/ROOT/pages/astream-subscriptions-keyshared.adoc
@@ -5,7 +5,7 @@
 
 _Subscriptions_ in {pulsar-reg} describe which consumers are consuming data from a topic and how they want to consume that data.
 
-{pulsar-short}'s xref:astream-subscriptions-shared.adoc[shared subscription] model can increase the message processing rate, but it risks losing message ordering guarantees.
+{pulsar-short}'s xref:ROOT:astream-subscriptions-shared.adoc[shared subscription] model can increase the message processing rate, but it risks losing message ordering guarantees.
 In a round-robin delivery, there's no way for the broker to know which messages are going to which consumer.
 
 _Key shared subscriptions_ allow multiple consumers to subscribe to a topic, and provide additional metadata in the form of _keys_ that link messages to specific consumers.
@@ -38,7 +38,7 @@ If you need to set fixed hash ranges, use the `<<use-stickyhashrange,stickyHashR
 === Use autoSplitHashRange
 
 To automatically assign hash ranges to consumers, use the `autoSplitHashRange` policy.
-Running multiple consumers with `autoSplitHashRange` balances the messaging load across all available consumers, like a xref:astream-subscriptions-shared.adoc[shared subscription].
+Running multiple consumers with `autoSplitHashRange` balances the messaging load across all available consumers, like a xref:ROOT:astream-subscriptions-shared.adoc[shared subscription].
 
 . In `src/main/java/com/datastax/pulsar`, create a `SimplePulsarConsumer.java` file with the following contents:
 +
@@ -211,7 +211,7 @@ Then, you can launch multiple instances of `SimplePulsarConsumer.java` to consum
 
 == See also
 
-* xref:astream-subscriptions.adoc[]
-* xref:astream-subscriptions-exclusive.adoc[]
-* xref:astream-subscriptions-shared.adoc[]
-* xref:astream-subscriptions-failover.adoc[]
\ No newline at end of file
+* xref:ROOT:astream-subscriptions.adoc[]
+* xref:ROOT:astream-subscriptions-exclusive.adoc[]
+* xref:ROOT:astream-subscriptions-shared.adoc[]
+* xref:ROOT:astream-subscriptions-failover.adoc[]
\ No newline at end of file
diff --git a/modules/ROOT/pages/astream-subscriptions-shared.adoc b/modules/ROOT/pages/astream-subscriptions-shared.adoc
index a3dbb98..8a4b5ec 100644
--- a/modules/ROOT/pages/astream-subscriptions-shared.adoc
+++ b/modules/ROOT/pages/astream-subscriptions-shared.adoc
@@ -70,14 +70,14 @@ The new consumer subscribes to the topic and consumes messages:
 ----
 
 Because this test uses shared subscriptions, you can attach multiple consumers to the topic.
-If you run this test with xref:astream-subscriptions-exclusive.adoc[exclusive subscriptions], you cannot attach more than once subscriber to the exclusive topic.
+If you run this test with xref:ROOT:astream-subscriptions-exclusive.adoc[exclusive subscriptions], you cannot attach more than once subscriber to the exclusive topic.
 
 To continue testing the shared subscription configuration, you can continue running new instances of `SimplePulsarConsumer.java` in new terminal windows.
 All the consumers subscribe to the topic and consume messages in a round-robin fashion.
 
 == See also
 
-* xref:astream-subscriptions.adoc[]
-* xref:astream-subscriptions-exclusive.adoc[]
-* xref:astream-subscriptions-failover.adoc[]
-* xref:astream-subscriptions-keyshared.adoc[]
+* xref:ROOT:astream-subscriptions.adoc[]
+* xref:ROOT:astream-subscriptions-exclusive.adoc[]
+* xref:ROOT:astream-subscriptions-failover.adoc[]
+* xref:ROOT:astream-subscriptions-keyshared.adoc[]
\ No newline at end of file
diff --git a/modules/ROOT/pages/astream-subscriptions.adoc b/modules/ROOT/pages/astream-subscriptions.adoc
index a73ddf5..2bac50d 100644
--- a/modules/ROOT/pages/astream-subscriptions.adoc
+++ b/modules/ROOT/pages/astream-subscriptions.adoc
@@ -27,13 +27,12 @@ pulsarConsumer = pulsarClient.newConsumer(Schema.BYTES)
 
 == Subscription types
 
-* xref:astream-subscriptions-exclusive.adoc[Exclusive subscriptions]
-* xref:astream-subscriptions-shared.adoc[Shared subscriptions]
-* xref:astream-subscriptions-failover.adoc[Failover subscriptions]
-* xref:astream-subscriptions-keyshared.adoc[Key shared subscriptions]
+* xref:ROOT:astream-subscriptions-exclusive.adoc[Exclusive subscriptions]
+* xref:ROOT:astream-subscriptions-shared.adoc[Shared subscriptions]
+* xref:ROOT:astream-subscriptions-failover.adoc[Failover subscriptions]
+* xref:ROOT:astream-subscriptions-keyshared.adoc[Key shared subscriptions]
 
 == See also
 
 * xref:getting-started:index.adoc[]
-* xref:developing:starlight.adoc[]
-
+* xref:developing:starlight.adoc[]
\ No newline at end of file
diff --git a/modules/developing/pages/astream-functions.adoc b/modules/developing/pages/astream-functions.adoc
index 97242b4..7e7bd8b 100644
--- a/modules/developing/pages/astream-functions.adoc
+++ b/modules/developing/pages/astream-functions.adoc
@@ -177,7 +177,7 @@ mvn package
 [#deploy-the-function-with-the-pulsar-cli]
 === Deploy the function with the {pulsar-short} CLI
 
-. If you haven't done so already, xref:configure-pulsar-env.adoc[set up your environment for the {pulsar-short} binaries].
+. If you haven't done so already, xref:developing:configure-pulsar-env.adoc[set up your environment for the {pulsar-short} binaries].
 
 . Create a deployment configuration YAML file that defines the function metadata and associated topics:
 +
diff --git a/modules/developing/pages/clients/index.adoc b/modules/developing/pages/clients/index.adoc
index bdecc48..92cf713 100644
--- a/modules/developing/pages/clients/index.adoc
+++ b/modules/developing/pages/clients/index.adoc
@@ -10,9 +10,9 @@ You should use this API version or higher.
 
 For more information and examples, see the following:
 
-* xref:clients/csharp-produce-consume.adoc[C#]
-* xref:clients/golang-produce-consume.adoc[Golang]
-* xref:clients/java-produce-consume.adoc[Java]
-* xref:clients/nodejs-produce-consume.adoc[Node.js]
-* xref:clients/python-produce-consume.adoc[Python]
-* xref:clients/spring-produce-consume.adoc[Spring Boot]
\ No newline at end of file
+* xref:developing:clients/csharp-produce-consume.adoc[C#]
+* xref:developing:clients/golang-produce-consume.adoc[Golang]
+* xref:developing:clients/java-produce-consume.adoc[Java]
+* xref:developing:clients/nodejs-produce-consume.adoc[Node.js]
+* xref:developing:clients/python-produce-consume.adoc[Python]
+* xref:developing:clients/spring-produce-consume.adoc[Spring Boot]
\ No newline at end of file
diff --git a/modules/developing/pages/configure-pulsar-env.adoc b/modules/developing/pages/configure-pulsar-env.adoc
index 51d64d4..7d0b348 100644
--- a/modules/developing/pages/configure-pulsar-env.adoc
+++ b/modules/developing/pages/configure-pulsar-env.adoc
@@ -80,4 +80,4 @@ Run some commands to validate the binary configuration.
 
 == See also
 
-* xref:produce-consume-pulsar-client.adoc[]
\ No newline at end of file
+* xref:developing:produce-consume-pulsar-client.adoc[]
\ No newline at end of file
diff --git a/modules/developing/pages/produce-consume-astra-portal.adoc b/modules/developing/pages/produce-consume-astra-portal.adoc
index c712ef4..40463f5 100644
--- a/modules/developing/pages/produce-consume-astra-portal.adoc
+++ b/modules/developing/pages/produce-consume-astra-portal.adoc
@@ -31,5 +31,5 @@ Produced and consumed messages are printed in a chat style format in the **Test
 
 == See also
 
-* xref:astream-functions.adoc[]
-* xref:astream-cdc.adoc[]
\ No newline at end of file
+* xref:developing:astream-functions.adoc[]
+* xref:developing:astream-cdc.adoc[]
\ No newline at end of file
diff --git a/modules/developing/pages/produce-consume-pulsar-client.adoc b/modules/developing/pages/produce-consume-pulsar-client.adoc
index 6d33bf9..7d91992 100644
--- a/modules/developing/pages/produce-consume-pulsar-client.adoc
+++ b/modules/developing/pages/produce-consume-pulsar-client.adoc
@@ -243,7 +243,7 @@ Delete a source connector::
 == See also
 
 * xref:developing:clients/index.adoc[]
-* xref:astream-functions.adoc[]
-* xref:astream-cdc.adoc[]
+* xref:developing:astream-functions.adoc[]
+* xref:developing:astream-cdc.adoc[]
 * xref:connectors:index.adoc[]
 * xref:developing:astream-functions.adoc[]
\ No newline at end of file
diff --git a/modules/operations/pages/astream-pricing.adoc b/modules/operations/pages/astream-pricing.adoc
index fb35e26..22c505b 100644
--- a/modules/operations/pages/astream-pricing.adoc
+++ b/modules/operations/pages/astream-pricing.adoc
@@ -48,13 +48,13 @@ These include, but are not limited to, the following:
 
 == Limits
 
-Regardless of your plan or cluster type, {product} applies xref:astream-limits.adoc[guardrails and limits] on resource creation to ensure best practices, foster availability, and promote optimal configurations for your databases.
+Regardless of your plan or cluster type, {product} applies xref:operations:astream-limits.adoc[guardrails and limits] on resource creation to ensure best practices, foster availability, and promote optimal configurations for your databases.
 
 Streaming Capacity Units have fewer limits than shared clusters.
 
 == Regions
 
-With shared clusters, you can create tenants in any of the xref:astream-regions.adoc[supported regions].
+With shared clusters, you can create tenants in any of the xref:operations:astream-regions.adoc[supported regions].
 
 Streaming Capacity Units are open to almost any public cloud region.
 For this reason, Streaming Capacity Units offer more flexibility for xref:operations:astream-georeplication.adoc[georeplication].
diff --git a/modules/operations/pages/astream-scrape-metrics.adoc b/modules/operations/pages/astream-scrape-metrics.adoc
index 93f9c66..b672cea 100644
--- a/modules/operations/pages/astream-scrape-metrics.adoc
+++ b/modules/operations/pages/astream-scrape-metrics.adoc
@@ -141,6 +141,6 @@ A tenant can only access its own metrics on the broker pod or function worker po
 
 == See also
 
-* xref:monitoring/index.adoc[]
+* xref:operations:monitoring/index.adoc[]
 * xref:getting-started:index.adoc[]
 * https://prometheus.io/docs/introduction/overview/[Prometheus documentation]
\ No newline at end of file
diff --git a/modules/operations/pages/monitoring/index.adoc b/modules/operations/pages/monitoring/index.adoc
index 264b859..3468e55 100644
--- a/modules/operations/pages/monitoring/index.adoc
+++ b/modules/operations/pages/monitoring/index.adoc
@@ -15,7 +15,7 @@ For a complete {pulsar-short} metrics reference, see:
 
 * https://pulsar.apache.org/docs/reference-metrics/#topic-metrics[Topic metrics]
 
-For a complete {product} metrics reference, see xref:monitoring/metrics.adoc[].
+For a complete {product} metrics reference, see xref:operations:monitoring/metrics.adoc[].
 
 == {product} metrics
 
@@ -263,7 +263,7 @@ The following table gives the list of recommended source connector metrics as a
 [IMPORTANT]
 ====
 Do _not_ aggregate metrics on shared clusters because one cluster can be shared among multiple organizations.
-For more information, see xref:astream-limits.adoc[] and xref:operations:astream-pricing.adoc[].
+For more information, see xref:operations:astream-limits.adoc[] and xref:operations:astream-pricing.adoc[].
 ====
 
 Each externally exposed raw {product} metric is reported at a very low level, at each individual server instance (the `exported_instance` label) and each topic partition (the `topic` label). The same raw metrics could come from multiple server instances. From an {product} user's perspective, the direct monitoring of raw metrics is not really useful. Raw metrics need to be aggregated first - for example, by averaging or summing the raw metrics over a period of time.
@@ -417,6 +417,6 @@ If your receive too many false alarms, adjust the alert threshold to a higher va
 
 == See also
 
-* xref:monitoring/metrics.adoc[]
-* xref:monitoring/integration.adoc[]
-* xref:monitoring/new-relic.adoc[]
\ No newline at end of file
+* xref:operations:monitoring/metrics.adoc[]
+* xref:operations:monitoring/integration.adoc[]
+* xref:operations:monitoring/new-relic.adoc[]
\ No newline at end of file
diff --git a/modules/operations/pages/monitoring/integration.adoc b/modules/operations/pages/monitoring/integration.adoc
index 2877a2e..7647f2d 100644
--- a/modules/operations/pages/monitoring/integration.adoc
+++ b/modules/operations/pages/monitoring/integration.adoc
@@ -96,11 +96,10 @@ Make sure the additional scrape job is in `UP` status.
 If not, review the configuration instructions and YAML examples to ensure your configuration is correct.
 +
 If the additional scrape job returns a `401 Unauthorized` error, make sure your {pulsar-short} JWT isn't expired.
-For more information, see xref:astream-token-gen.adoc[].
+For more information, see xref:operations:astream-token-gen.adoc[].
 
 == See also
 
-* xref:monitoring/index.adoc[]
-* xref:monitoring/metrics.adoc[]
-* xref:monitoring/new-relic.adoc[]
-
+* xref:operations:monitoring/index.adoc[]
+* xref:operations:monitoring/metrics.adoc[]
+* xref:operations:monitoring/new-relic.adoc[]
\ No newline at end of file
diff --git a/modules/operations/pages/monitoring/metrics.adoc b/modules/operations/pages/monitoring/metrics.adoc
index c2ef642..9254137 100644
--- a/modules/operations/pages/monitoring/metrics.adoc
+++ b/modules/operations/pages/monitoring/metrics.adoc
@@ -1,10 +1,10 @@
 = Grafana dashboards for {product} metrics
 
 {company} provides Grafana dashboards for core message processing for exposed {product} metrics.
-Use these dashboards as a starting point for xref:monitoring/index.adoc[monitoring your {product} deployment], and then customize them as needed.
+Use these dashboards as a starting point for xref:operations:monitoring/index.adoc[monitoring your {product} deployment], and then customize them as needed.
 
 Dashboards are available for scraping metrics {pulsar-short}'s tenant, namespace, and topic levels:
 
-* Tenant level metrics: xref:monitoring/overview-dashboard.adoc[]
-* Namespace level metrics: xref:monitoring/namespace-dashboard.adoc[]
-* Topic level metrics: xref:monitoring/topic-dashboard.adoc[]
\ No newline at end of file
+* Tenant level metrics: xref:operations:monitoring/overview-dashboard.adoc[]
+* Namespace level metrics: xref:operations:monitoring/namespace-dashboard.adoc[]
+* Topic level metrics: xref:operations:monitoring/topic-dashboard.adoc[]
\ No newline at end of file
diff --git a/modules/operations/pages/monitoring/namespace-dashboard.adoc b/modules/operations/pages/monitoring/namespace-dashboard.adoc
index bccc747..2f38639 100644
--- a/modules/operations/pages/monitoring/namespace-dashboard.adoc
+++ b/modules/operations/pages/monitoring/namespace-dashboard.adoc
@@ -45,5 +45,5 @@ Georeplication displays the time series metrics chart summarized at the namespac
 
 == See also
 
-* xref:monitoring/overview-dashboard.adoc[]
-* xref:monitoring/topic-dashboard.adoc[]
\ No newline at end of file
+* xref:operations:monitoring/overview-dashboard.adoc[]
+* xref:operations:monitoring/topic-dashboard.adoc[]
\ No newline at end of file
diff --git a/modules/operations/pages/monitoring/new-relic.adoc b/modules/operations/pages/monitoring/new-relic.adoc
index 4830622..480c0f6 100644
--- a/modules/operations/pages/monitoring/new-relic.adoc
+++ b/modules/operations/pages/monitoring/new-relic.adoc
@@ -4,13 +4,13 @@ While there are multiple ways to https://docs.newrelic.com/docs/infrastructure/p
 
 == Prerequisites
 
-* Review xref:monitoring/index.adoc[].
+* Review xref:operations:monitoring/index.adoc[].
 * https://docs.newrelic.com/[Set up a New Relic account.]
 * Save your New Relic license key locally.
 
 == Prepare the extra Prometheus server
 
-xref:monitoring/integration.adoc[Install an extra Prometheus server] to act as a bridge to forward scraped {product} metrics to New Relic.
+xref:operations:monitoring/integration.adoc[Install an extra Prometheus server] to act as a bridge to forward scraped {product} metrics to New Relic.
 
 This is required because {product} is a managed service, and you cannot modify the {product} Prometheus server as required by the New Relic Prometheus write integration.
 
@@ -64,6 +64,6 @@ prometheus:
 
 == See also
 
-* For a list of exposed endpoints for {product} metrics, see xref:monitoring/metrics.adoc[].
-* To scrape {product} metrics in Kubernetes with an external Prometheus server, see xref:monitoring/integration.adoc[].
-* To scrape {product} metrics into New Relic, see xref:monitoring/new-relic.adoc[].
\ No newline at end of file
+* For a list of exposed endpoints for {product} metrics, see xref:operations:monitoring/metrics.adoc[].
+* To scrape {product} metrics in Kubernetes with an external Prometheus server, see xref:operations:monitoring/integration.adoc[].
+* To scrape {product} metrics into New Relic, see xref:operations:monitoring/new-relic.adoc[].
\ No newline at end of file
diff --git a/modules/operations/pages/monitoring/overview-dashboard.adoc b/modules/operations/pages/monitoring/overview-dashboard.adoc
index 6f0ff21..0f7febc 100644
--- a/modules/operations/pages/monitoring/overview-dashboard.adoc
+++ b/modules/operations/pages/monitoring/overview-dashboard.adoc
@@ -49,5 +49,5 @@ Messaging displays the time series metrics chart summarized at the tenant level.
 
 == See also
 
-* xref:monitoring/namespace-dashboard.adoc[]
-* xref:monitoring/topic-dashboard.adoc[]
\ No newline at end of file
+* xref:operations:monitoring/namespace-dashboard.adoc[]
+* xref:operations:monitoring/topic-dashboard.adoc[]
\ No newline at end of file
diff --git a/modules/operations/pages/monitoring/topic-dashboard.adoc b/modules/operations/pages/monitoring/topic-dashboard.adoc
index 6995609..b52ad52 100644
--- a/modules/operations/pages/monitoring/topic-dashboard.adoc
+++ b/modules/operations/pages/monitoring/topic-dashboard.adoc
@@ -62,5 +62,5 @@ Georeplication displays the time series metrics chart summarized at the topic le
 
 == See also
 
-* xref:monitoring/overview-dashboard.adoc[]
-* xref:monitoring/namespace-dashboard.adoc[]
\ No newline at end of file
+* xref:operations:monitoring/overview-dashboard.adoc[]
+* xref:operations:monitoring/namespace-dashboard.adoc[]
\ No newline at end of file