more fixes

aantn · aantn · commit c563d92c30f5 · 2025-10-30T10:04:21.000+02:00
diff --git a/docs/conf.py b/docs/conf.py
@@ -213,7 +213,9 @@
     "how-it-works/alert-builtin-enrichment.html": "/master/playbook-reference/builtin-alert-enrichment.html",
     "setup-robusta/installation/extend-prometheus-installation.html": "/master/setup-robusta/installation/standalone-installation.html",
     "playbook-reference/defining-playbooks/index.html": "/master/playbook-reference/index.html",
-    "configuration/alertmanager-integration/alert-custom-prometheus.html": "/master/configuration/alertmanager-integration/embedded-prometheus.html#creating-custom-prometheus-alerts"
+    "configuration/alertmanager-integration/alert-custom-prometheus.html": "/master/configuration/alertmanager-integration/embedded-prometheus.html#creating-custom-prometheus-alerts",
+    "configuration/alertmanager-integration/index.html": "/master/configuration/index.html",
+    "notification-routing/notification-routing-examples.html": "/master/notification-routing/index.html"
 } 
 
 
diff --git a/docs/configuration/alertmanager-integration/index.rst b/docs/configuration/alertmanager-integration/index.rst
diff --git a/docs/notification-routing/notification-routing-examples.rst b/docs/notification-routing/notification-routing-examples.rst
diff --git a/docs/notification-routing/routing-with-scopes.rst b/docs/notification-routing/routing-with-scopes.rst
@@ -324,7 +324,7 @@ Here is the complete list of attributes that can be used in ``include`` / ``excl
 +---------------------+-----------------------------------------------------------+------------------------------------------+
 | ``annotations``     | Same as Kubernetes selectors: a comma-separated list of   | Can refer to both Kubernetes resource    |
 |                     | ``key=val`` pairs with AND between them. e.g.             | annotations and Prometheus alert         |
-|                     | ``app.kubernetes.io/name=prometheus``. Supports regex in  |        annotations. Prometheus values    |
+|                     | ``app.kubernetes.io/name=prometheus``. Supports regex in  | annotations. Prometheus values           |
 |                     | the value.                                                | are prioritized when both exist.         |
 +---------------------+-----------------------------------------------------------+------------------------------------------+
 | ``namespace_labels``| Labels on the Kubernetes namespace containing this object.| Same matching syntax as ``labels``. For  |
diff --git a/docs/playbook-reference/actions/scans.rst b/docs/playbook-reference/actions/scans.rst
@@ -9,7 +9,4 @@ These actions can be triggered:
 * On demand, via the Robusta UI.
 * On demand, via :ref:`cli command <Manual Triggers>`.
 
-There are two built-in KRR and Popeye, you can find more details below.
-
-* :ref:`Cost Savings (KRR)`
-* :ref:`Kubernetes Misconfigurations (Popeye)`
+There are two built-in: KRR and Popeye.
diff --git a/docs/playbook-reference/defining-playbooks/builtin-playbooks.rst b/docs/playbook-reference/defining-playbooks/builtin-playbooks.rst
@@ -25,7 +25,7 @@ The following default playbook handles all Prometheus alerts that Robusta receiv
 
 There are additional enrichments for specific alerts. For example:
 
-To define additional playbooks for your own alerts, refer to the :ref:`Enhanced Prometheus Alerts` tutorial.
+To define additional playbooks for your own alerts, refer to the :doc:`Custom Alert Enrichment </playbook-reference/prometheus-examples/index>` guide.
 
 Default Prometheus Silencing
 --------------------------------
@@ -34,4 +34,4 @@ Robusta uses *silencer* actions to flag false positive alerts and prevent them f
 
 Silencers are just regular actions that call a special silencing API in their code.
 
-To define your own silencers, refer to the :ref:`Silencing Prometheus Alerts` tutorial.
+To define your own silencers, refer to the playbook actions documentation.
diff --git a/docs/playbook-reference/defining-playbooks/playbook-basics.rst b/docs/playbook-reference/defining-playbooks/playbook-basics.rst
@@ -5,7 +5,7 @@ Playbook Basics
 
 A playbook is an automation rule for detecting, investigating, or fixing problems in your cluster.
 
-For a gentle introduction, see :ref:`What are Playbooks?<how-it-works-index>`
+For a gentle introduction, see :doc:`Playbook Overview </playbook-reference/overview>`
 
 Overview
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
diff --git a/docs/playbook-reference/triggers/kubernetes.rst b/docs/playbook-reference/triggers/kubernetes.rst
@@ -9,9 +9,7 @@ These triggers work even when Prometheus is not connected to Robusta. They're tr
 
 .. details:: Related Tutorials
 
-    * :ref:`Track Failed Kubernetes Jobs`
-    * :ref:`Track Failed Liveness Probes`
-    * :ref:`Track Kubernetes Changes`
+    * :doc:`Kubernetes Change Notifications </playbook-reference/kubernetes-examples/kubernetes-change-notifications>`
 
 
 Crashing Pod Triggers
@@ -81,7 +79,7 @@ The following triggers are available for crashing Pods:
         * If A `name` is defined without a `namespace` than all containers with that name prefix will be ignored for this trigger.
         * If A `namespace` is defined without a `name` than all containers in that namespace will be ignored for this trigger.
 
-    An example playbook using :ref:`oomkilled_container_graph_enricher<oomkilled_container_graph_enricher>`:
+    An example playbook using ``oomkilled_container_graph_enricher``:
 
     .. code-block:: yaml
 
diff --git a/docs/playbook-reference/triggers/prometheus.rst b/docs/playbook-reference/triggers/prometheus.rst
@@ -1,12 +1,11 @@
 Prometheus and AlertManager
 #############################
 
-Robusta can :ref:`improve your existing Prometheus alerts <Enhanced Prometheus Alerts>`. It can also execute
-:ref:`Remediation Actions <Automatic Remediation>` in response to alerts.
+Robusta can improve your existing Prometheus alerts. It can also execute automated remediation actions in response to alerts.
 
 Prerequisites
 ---------------
-AlertManager must be connected to Robusta. Refer to :ref:`Integrating AlertManager and Prometheus`.
+AlertManager must be connected to Robusta. Refer to the :doc:`Send Alerts </configuration/index>` documentation.
 
 Triggers
 -----------
diff --git a/docs/setup-robusta/installation-faq.rst b/docs/setup-robusta/installation-faq.rst
@@ -17,7 +17,7 @@ Yes, using the cli is optional. It auto-generates helm values, but you can also
     helm repo add robusta https://robusta-charts.storage.googleapis.com && helm repo update
     helm show values robusta/robusta
 
-2. Modify those values to your heart's content. Refer to the :ref:`Integration Guide <Integrations Overview>` for details.
+2. Modify those values to your heart's content. Refer to the :doc:`Send Alerts </configuration/index>` documentation for details.
 
 3. Do a ``helm install``.
 
@@ -52,7 +52,7 @@ Verify success by checking that Robusta pods are running:
 
 Does Robusta support Thanos/Cortex/Mimir/VictoriaMetrics?
 ============================================================
-Any Prometheus-compatible solution is fine. Just follow instructions under :ref:`Integrate with Existing Prometheus`
+Any Prometheus-compatible solution is fine. Just follow instructions in the :doc:`Send Alerts </configuration/index>` documentation.
 
 Can I use Robusta with DataDog?
 ============================================================
diff --git a/docs/setup-robusta/installation/_see_robusta_in_action.rst b/docs/setup-robusta/installation/_see_robusta_in_action.rst
diff --git a/playbooks/robusta_playbooks/kubectl_enrichments.py b/playbooks/robusta_playbooks/kubectl_enrichments.py
@@ -19,7 +19,7 @@
 
 class KubectlParams(PodRunningParams):
     """
-    :var kubectl_command: The full kubectl command to run, formatted as a shell command string.
+    :var command: The full kubectl command to run, formatted as a shell command string.
     :var description: A description of the command ran.
     :var timeout: The maximum time (in seconds) to wait for the kubectl command to complete. Default is 3600 seconds.
     """
diff --git a/playbooks/robusta_playbooks/sink_enrichments.py b/playbooks/robusta_playbooks/sink_enrichments.py
@@ -25,7 +25,7 @@ class SlackCallbackParams(ActionParams):
 
 class OpsGenieAckParams(SlackCallbackParams):
     """
-    :var alertmanager_url: Alternative Alert Manager url to send requests.
+    :var alert_fingerprint: The fingerprint of the alert to acknowledge.
     """
 
     alert_fingerprint: str

Original file line number	Diff line number	Diff line change
`@@ -213,7 +213,9 @@`
`213`	`213`	`"how-it-works/alert-builtin-enrichment.html": "/master/playbook-reference/builtin-alert-enrichment.html",`
`214`	`214`	`"setup-robusta/installation/extend-prometheus-installation.html": "/master/setup-robusta/installation/standalone-installation.html",`
`215`	`215`	`"playbook-reference/defining-playbooks/index.html": "/master/playbook-reference/index.html",`
`216`		`- "configuration/alertmanager-integration/alert-custom-prometheus.html": "/master/configuration/alertmanager-integration/embedded-prometheus.html#creating-custom-prometheus-alerts"`
	`216`	`+ "configuration/alertmanager-integration/alert-custom-prometheus.html": "/master/configuration/alertmanager-integration/embedded-prometheus.html#creating-custom-prometheus-alerts",`
	`217`	`+ "configuration/alertmanager-integration/index.html": "/master/configuration/index.html",`
	`218`	`+ "notification-routing/notification-routing-examples.html": "/master/notification-routing/index.html"`
`217`	`219`	`}`
`218`	`220`
`219`	`221`