more improvements

Author: aantn

docs/conf.py

@@ -92,9 +92,11 @@
     "configuration/defining-playbooks/creating-notifications.html": "/master/playbook-reference/defining-playbooks/creating-notifications.html",
     "configuration/defining-playbooks/external-playbook-repositories.html": "/master/playbook-reference/defining-playbooks/external-playbook-repositories.html",
     "configuration/defining-playbooks/index.html": "/master/playbook-reference/defining-playbooks/index.html",
-    "configuration/defining-playbooks/playbook-advanced.html": "/master/playbook-reference/defining-playbooks/playbook-advanced.html",
-    "configuration/defining-playbooks/playbook-basics.html": "/master/playbook-reference/defining-playbooks/playbook-basics.html",
-    "configuration/defining-playbooks/trigger-action-binding.html": "/master/playbook-reference/defining-playbooks/trigger-action-binding.html",
+    "configuration/defining-playbooks/playbook-advanced.html": "/master/playbook-reference/index.html",
+    "playbook-reference/defining-playbooks/playbook-advanced.html": "/master/playbook-reference/index.html",
+    "configuration/defining-playbooks/playbook-basics.html": "/master/playbook-reference/index.html",
+    "configuration/defining-playbooks/trigger-action-binding.html": "/master/playbook-reference/index.html#matching-actions-to-triggers",
+    "playbook-reference/defining-playbooks/trigger-action-binding.html": "/master/playbook-reference/index.html#matching-actions-to-triggers",
     "configuration/additional-settings.html": "/master/setup-robusta/additional-settings.html",
     "developer-guide/writing-playbooks.html": "/master/playbook-reference/defining-playbooks/index.html",
     "user-guide/slack.html": "/master/configuration/sinks/slack.html",
@@ -168,7 +170,7 @@
     "user-guide/embedded-prometheus.html": "/master/configuration/alertmanager-integration/embedded-prometheus.html#enabling-the-embedded-prometheus",
     "user-guide/node-selector.html": "/master/setup-robusta/node-selector.html",
     "user-guide/interactivity.html": "/master/setup-robusta/additional-settings.html#two-way-interactivity",
-    "user-guide/flow-control.html": "/master/playbook-reference/defining-playbooks/playbook-advanced.html#using-filters-to-restrict-triggers",
+    "user-guide/flow-control.html": "/master/playbook-reference/index.html#using-filters-to-restrict-triggers",
     "catalog/triggers/index.html": "/master/playbook-reference/triggers/index.html",
     "catalog/triggers/kubernetes.html": "/master/playbook-reference/triggers/kubernetes.html",
     "catalog/triggers/smart.html": "/master/playbook-reference/triggers/kubernetes.html",
@@ -190,7 +192,7 @@
     "catalog/sinks/webex.html": "/master/configuration/sinks/webex.html",
     "catalog/sinks/VictorOps.html": "/master/configuration/sinks/VictorOps.html",
     "catalog/sinks/file.html": "/master/configuration/sinks/file.html",
-    "user-guide/trigger-action-binding.html": "/master/playbook-reference/defining-playbooks/playbook-basics.html#understanding-actions",
+    "user-guide/trigger-action-binding.html": "/master/playbook-reference/index.html#understanding-actions",
     "advanced/privacy-and-security.html": "/master/setup-robusta/privacy-and-security.html",
     "advanced/robusta-ui-triggers.html": "/master/setup-robusta/installation/index.html",
     "developer-guide/actions/index.html": "/master/playbook-reference/actions/index.html",
@@ -210,7 +212,9 @@
     "configuration/alertmanager-integration/troubleshooting-alertmanager.html": "/master/configuration/exporting/send-alerts-api.html",
     "configuration/alertmanager-integration/grafana-alert-manager.html": "/master/configuration/alertmanager-integration/grafana-self-hosted.html",
     "configuration/alertmanager-integration/grafana-cloud-mimir.html": "/master/configuration/alertmanager-integration/grafana-cloud.html",
-    "playbook-reference/what-are-playbooks.html": "/master/playbook-reference/overview.html",
+    "playbook-reference/what-are-playbooks.html": "/master/playbook-reference/index.html",
+    "playbook-reference/overview.html": "/master/playbook-reference/index.html",
+    "playbook-reference/defining-playbooks/playbook-basics.html": "/master/playbook-reference/index.html",
     "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",

docs/help.rst

@@ -1,5 +1,7 @@
 :hide-toc:
 
+.. _Getting Support:
+
 Getting Support
 ================
 

docs/index.rst

@@ -144,8 +144,14 @@
    :hidden:
 
    playbook-reference/index
-   Enrich Alerts <playbook-reference/builtin-alert-enrichment>
-   Kubernetes Change Notifications <playbook-reference/kubernetes-examples/kubernetes-change-notifications>
+   Playbook Notifications <playbook-reference/defining-playbooks/creating-notifications>
+   Alert Enrichment <playbook-reference/builtin-alert-enrichment>
+   Automatic Remediation <playbook-reference/automatic-remediation-examples/index>
+   Silencer Playbooks <playbook-reference/defining-playbooks/silencer-playbooks>
+   Triggers Reference <playbook-reference/triggers/index>
+   Actions Reference <playbook-reference/actions/index>
+   Log Based Alerting <playbook-reference/logs-triggers/index>
+   K8s Change Notification <playbook-reference/kubernetes-examples/kubernetes-change-notifications>
    Cost Savings - KRR <configuration/resource-recommender>
 
 .. toctree::

docs/notification-routing/routing-silencing.rst

@@ -35,4 +35,5 @@ node that just restarted.
 Further Reading
 -----------------
 
+* Learn more about :ref:`Silencer Playbooks <Silencer Playbooks>`
 * View all :ref:`Prometheus Silencer <Prometheus Silencers>` actions

docs/playbook-reference/actions/develop-actions/index.rst

@@ -18,6 +18,7 @@ Please consider sharing your custom actions with the community.
    my-first-custom-action
    playbook-repositories
    loading-custom-actions
+   Loading External Actions <../../defining-playbooks/external-playbook-repositories>
    overriding-builtin-actions
    findings-api
    triggers-and-events

docs/playbook-reference/actions/develop-actions/loading-custom-actions.rst

@@ -1,3 +1,5 @@
+.. _Loading Custom Actions into Robusta:
+
 Loading Custom Actions into Robusta
 ####################################
 

docs/playbook-reference/actions/develop-actions/playbook-repositories.rst

@@ -1,3 +1,5 @@
+.. _Creating Playbook Repositories:
+
 Creating Playbook Repositories
 ################################
 

docs/playbook-reference/actions/index.rst

@@ -1,5 +1,7 @@
 :hide-toc:
 
+.. _Actions Reference:
+
 Actions Reference
 ==================
 

docs/playbook-reference/builtin-alert-enrichment.rst

@@ -1,6 +1,6 @@
 .. _builtin-alert-enrichment:
 
-Enrich Alerts
+Alert Enrichment
 ########################################
 
 Ever feel overwhelmed by alerts that lack context? Robusta enriches alerts automatically and lets you create custom enrichment rules.

docs/playbook-reference/defining-playbooks/external-playbook-repositories.rst

@@ -1,3 +1,5 @@
+.. _Loading External Actions:
+
 Loading External Actions
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^