Rename selector label to 'Select Region' and migrate all docs

Two changes:

1. Rename the bar label from "Region" to "Select Region" in the
   selector UI.

2. Migrate every documentation page that mentions platform.robusta.dev
   or api.robusta.dev so the region selector is visible wherever the
   user encounters a Robusta endpoint. Concretely, replace
   .. code-block:: <lang> with .. robusta-code:: <lang> for any code
   block whose body contains a Robusta URL — 65 blocks across 36 files.
   Pages whose only mention is an inline external link (signup CTAs,
   prose references) are intentionally left as-is; the page-wide JS
   still rewrites those URLs to the selected region using the value
   persisted in localStorage from any page that does carry a selector.

The JS also now collects URL targets from the whole content area
rather than scoping them to each box, so a selector click on any
component on the page rewrites every Robusta URL it can reach
(prose, tables, code, anchor hrefs).

Author: claude

docs/_static/region-selector.js

@@ -34,12 +34,13 @@
     });
   }
 
-  // Each box on the page has its own collection of URL targets so its
-  // contents update in place when the region changes.
+  // All URL occurrences across the page content (text nodes + relevant
+  // attributes). Boxes are separate — each holds its selector buttons so
+  // every box on the page stays visually in sync on region change.
+  const targets = [];
   const boxes = [];
 
   function collectTargets(root) {
-    const targets = [];
     const walker = document.createTreeWalker(root, NodeFilter.SHOW_TEXT, {
       acceptNode: function (node) {
         if (!node.nodeValue || !DETECT_PATTERN.test(node.nodeValue)) {
@@ -66,35 +67,32 @@
         }
       });
     });
-    return targets;
   }
 
-  function applyToBox(box, regionKey) {
-    for (let i = 0; i < box.targets.length; i++) {
-      const t = box.targets[i];
+  function applyRegion(regionKey) {
+    for (let i = 0; i < targets.length; i++) {
+      const t = targets[i];
       const next = rewrite(t.original, regionKey);
       if (t.kind === "text") {
         if (t.node.nodeValue !== next) t.node.nodeValue = next;
       } else {
         if (t.node.getAttribute(t.attr) !== next) t.node.setAttribute(t.attr, next);
       }
     }
-    updateBoxButtons(box, regionKey);
-  }
-
-  function updateBoxButtons(box, regionKey) {
-    box.buttons.forEach(function (btn) {
-      const isActive = btn.getAttribute("data-region") === regionKey;
-      btn.classList.toggle("is-active", isActive);
-      btn.setAttribute("aria-checked", String(isActive));
-    });
+    for (let j = 0; j < boxes.length; j++) {
+      const buttons = boxes[j].buttons;
+      for (let k = 0; k < buttons.length; k++) {
+        const btn = buttons[k];
+        const active = btn.getAttribute("data-region") === regionKey;
+        btn.classList.toggle("is-active", active);
+        btn.setAttribute("aria-checked", String(active));
+      }
+    }
   }
 
   function syncAll(regionKey) {
     saveRegion(regionKey);
-    boxes.forEach(function (box) {
-      applyToBox(box, regionKey);
-    });
+    applyRegion(regionKey);
   }
 
   function buildBar(currentRegion) {
@@ -103,7 +101,7 @@
 
     const label = document.createElement("span");
     label.className = "robusta-region-box__bar-label";
-    label.textContent = "Region";
+    label.textContent = "Select Region";
     bar.appendChild(label);
 
     const group = document.createElement("div");
@@ -133,28 +131,10 @@
     return { bar: bar, buttons: buttons };
   }
 
-  function initBox(el, currentRegion) {
-    const existingBar = el.querySelector(":scope > ." + BAR_CLASS);
-    if (existingBar) existingBar.remove();
-
-    const built = buildBar(currentRegion);
-    el.insertBefore(built.bar, el.firstChild);
-
-    const targetRoot = el.querySelector(".robusta-region-box__body") || el;
-    const targets = collectTargets(targetRoot);
-
-    const box = {
-      el: el,
-      bar: built.bar,
-      buttons: built.buttons,
-      targets: targets,
-    };
-    boxes.push(box);
-    applyToBox(box, currentRegion);
-  }
-
   function init() {
+    targets.length = 0;
     boxes.length = 0;
+
     const content =
       document.querySelector(".md-content__inner") ||
       document.querySelector("article") ||
@@ -163,10 +143,20 @@
     if (!content) return;
 
     const region = getRegion();
-    const elements = content.querySelectorAll(".robusta-region-box");
-    elements.forEach(function (el) {
-      initBox(el, region);
+
+    content.querySelectorAll(".robusta-region-box").forEach(function (el) {
+      const existingBar = el.querySelector(":scope > ." + BAR_CLASS);
+      if (existingBar) existingBar.remove();
+      const built = buildBar(region);
+      el.insertBefore(built.bar, el.firstChild);
+      boxes.push({ buttons: built.buttons });
     });
+
+    collectTargets(content);
+
+    if (targets.length === 0 && boxes.length === 0) return;
+
+    applyRegion(region);
   }
 
   if (document.readyState === "loading") {

docs/configuration/alertmanager-integration/coralogix_managed_prometheus.rst

@@ -20,7 +20,7 @@ Common Configuration (for both webhooks)
 1. In the Coralogix site go to Data Flow, then Outbound Webhooks, and click ``Generic webhook``.
 2. In the url insert:
 
-.. code-block::
+.. robusta-code::
 
     https://api.robusta.dev/integrations/generic/alertmanager
 

docs/configuration/alertmanager-integration/google-managed-alertmanager.rst

@@ -22,7 +22,7 @@ Configure the Alertmanager webhook
 
 Apply the following Secret in the GMP namespace (default ``gmp-public``). Replace ``<ACCOUNT_ID>`` and ``<SIGNING_KEY>`` with your credentials.
 
-.. code-block:: yaml
+.. robusta-code:: yaml
 
    apiVersion: v1
    kind: Secret
@@ -103,7 +103,7 @@ Optional: verify credentials with curl
 
 You can manually validate the webhook and credentials by posting a sample alert:
 
-.. code-block:: bash
+.. robusta-code:: bash
 
    curl -X POST 'https://api.robusta.dev/integrations/generic/alertmanager' \
      -H 'Authorization: Bearer <ACCOUNT_ID> <SIGNING_KEY>' \

docs/configuration/alertmanager-integration/grafana-self-hosted.rst

@@ -44,7 +44,7 @@ Generate and save your new ``API Key``
 Select ``Webhook`` from the Integration options.
 Add the following URL. Add your ``account_id`` to it:
 
-.. code-block::
+.. robusta-code::
 
     https://api.robusta.dev/integrations/alerts/grafana?account_id=YOUR_ACCOUNT_ID
 
@@ -111,7 +111,7 @@ To configure it:
 
 2. Insert the following URL:
 
-.. code-block::
+.. robusta-code::
 
     https://api.robusta.dev/integrations/generic/alertmanager
 

docs/configuration/alertmanager-integration/nagios.rst

@@ -14,7 +14,7 @@ Requirements
 - Robusta must already be deployed and running in your environment.
 - The Nagios host must be able to send `curl` requests to the Robusta API endpoint:
 
-  .. code-block::
+  .. robusta-code::
 
      https://api.robusta.dev/integrations/generic/nagios
 
@@ -80,7 +80,7 @@ Step 4: Create the Bash Command Script
 
 Save this as `notify-robusta.sh`, ensure it's executable (`chmod +x notify-robusta.sh`), and Nagios can access it.
 
-.. code-block:: bash
+.. robusta-code:: bash
 
     #!/bin/sh
 

docs/configuration/alertmanager-integration/outofcluster-prometheus.rst

@@ -21,7 +21,7 @@ This integration lets your central Prometheus send alerts to Robusta, as if they
 
 .. admonition:: alertmanager.yaml
 
-    .. code-block:: yaml
+    .. robusta-code:: yaml
 
         receivers:
           - name: 'robusta'
@@ -72,7 +72,7 @@ If you are using a third-party AlertManager and want to give it separate credent
 
 .. admonition:: alertmanager.yaml
 
-    .. code-block:: yaml
+    .. robusta-code:: yaml
 
         receivers:
           - name: 'robusta'

docs/configuration/alertmanager-integration/pagerduty-alerting.rst

@@ -47,7 +47,7 @@ Set the following values:
 
 * **Webhook URL**:
 
-.. code-block::
+.. robusta-code::
 
     https://api.robusta.dev/integrations/generic/pagerduty/incidents
 
@@ -88,7 +88,7 @@ Step 1: Create an Integration for Alertmanager
 1. In Event Orchestration, create a new **Integration** named ``Alertmanager``.
 2. Use the following webhook URL:
 
-.. code-block::
+.. robusta-code::
 
     https://api.robusta.dev/integrations/generic/pagerduty/alerts
 
@@ -116,7 +116,7 @@ Step 3: Add a Webhook Action
 
 * **URL**:
 
-.. code-block::
+.. robusta-code::
 
     https://api.robusta.dev/integrations/generic/pagerduty/alerts
 
@@ -171,15 +171,15 @@ Optional: Cluster Name via Query Param
 
 You can specify the target cluster using a query parameter in the webhook URL:
 
-.. code-block::
+.. robusta-code::
 
     https://api.robusta.dev/integrations/generic/pagerduty/incidents?cluster=your-cluster-name
 
 This is useful for multi-cluster setups where Robusta should assign findings to a specific cluster.
 
 For example:
 
-.. code-block::
+.. robusta-code::
 
     https://api.robusta.dev/integrations/generic/pagerduty/incidents?cluster=test-cluster
 

docs/configuration/alertmanager-integration/solarwinds.rst

@@ -37,7 +37,7 @@ Step 3: Create a Webhook Configuration in SolarWinds
    - **Description**: Robusta Webhook
    - **Destination URL**:
 
-     .. code-block::
+     .. robusta-code::
 
         https://api.robusta.dev/integrations/generic/solarwinds?account_id=ACCOUNT_ID_HERE
 

docs/configuration/exporting/alert-export-api.rst

@@ -48,7 +48,7 @@ Example Request
 
 The following ``curl`` command demonstrates how to export alert history data for the ``CrashLoopBackoff`` alert:
 
-.. code-block:: bash
+.. robusta-code:: bash
 
     curl --location 'https://api.robusta.dev/api/query/alerts?alert_name=CrashLoopBackoff&account_id=ACCOUNT_ID&start_ts=2024-09-02T04%3A02%3A05.032Z&end_ts=2024-09-17T05%3A02%3A05.032Z' \
     --header 'Authorization: Bearer API-KEY'

docs/configuration/exporting/alert-statistics-api.rst

@@ -41,7 +41,7 @@ Example Request
 
 The following `curl` command demonstrates how to query aggregated alert data for a specified time range:
 
-.. code-block:: bash
+.. robusta-code:: bash
 
     curl --location 'https://api.robusta.dev/api/query/report?account_id=XXXXXX-XXXX_XXXX_XXXXX7&start_ts=2024-10-27T04:02:05.032Z&end_ts=2024-11-27T05:02:05.032Z' \
     --header 'Authorization: Bearer API-KEY'