Refactor architecture documentation with clearer component overview (#2013)

* Update architecture and oss-vs-saas docs to reflect current commercial architecture

- Rewrite architecture.rst around Agent/Platform/Data Sources model with
  new architecture diagram showing the in-cluster Agent, Robusta Platform
  (SaaS or self-hosted), data source integrations, and notification channels
- Update oss-vs-saas.rst to highlight HolmesGPT as the flagship open source
  project for AI-powered root cause analysis and position Robusta Classic
  as the deterministic alert enrichment engine

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Make HolmesGPT the primary focus of architecture and oss-vs-saas docs

- architecture.rst: Lead with HolmesGPT as the core AI investigation
  engine, frame the entire architecture around how HolmesGPT investigates
  alerts (receive → pull data → correlate → report)
- oss-vs-saas.rst: Make HolmesGPT the headline open source project,
  demote Robusta Classic to a small footnote section at the bottom for
  readers who encounter references to it elsewhere in the docs

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Remove 'How It Works' section from architecture docs

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Move Robusta Classic footnote to architecture, trim Agent bullets, remove Notification Channels

- Remove "Receiving alerts" and "Running HolmesGPT" bullets from Agent
  section (redundant with intro)
- Remove standalone Notification Channels section; mention sinks briefly
  under Robusta Classic instead
- Move Robusta Classic footnote from oss-vs-saas.rst to architecture.rst

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Update architecture diagram and align docs with new diagram

- Replace architecture-overview.png with new diagram
- Update data sources to match diagram: Prometheus, Datadog, AWS,
  Grafana, Jira (remove New Relic, CloudWatch, NPAW, Conviva, ServiceNow)
- Rewrite Kubernetes bullet as optional for K8s-specific use cases
- Simplify Data Sources section to a single list

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Remove cluster-specific wording from Platform section

Drop "across multiple clusters" to avoid Kubernetes-only framing.

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Replace notification routing with HolmesGPT Slack/Teams bot mention

Notification routing is a Robusta Classic feature. Replace the Platform
bullet with a reference to the HolmesGPT bot for Slack and Teams.

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Reframe Platform description as SRE agent control center

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Remove pro features link from Platform section

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Remove usage FAQ and revamp index page messaging

- Delete usage-faq.rst and its toctree entry
- Rewrite landing page to focus on AI-powered investigation, data
  sources, Slack/Teams bot, and the Platform as SRE agent control center
- Remove Kubernetes-centric OSS vs Pro comparison table
- Replace Robusta Classic features (Smart Grouping, Enrichment,
  Remediation) with HolmesGPT-focused feature list

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Remove outdated FAQ entries about DataDog, NewRelic, and monitoring replacement

These questions are no longer relevant given the updated messaging
around data source integrations.

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Consolidate sidebar sections into Other Features

Move 5 sidebar sections (Send Alerts, Track Config Changes, Notification
Sinks, Alert Routing, Advanced - Playbooks) under a single "Other
Features" group. Add hidden toctrees to each section's index page so
sub-pages remain accessible. No file paths changed so all existing URLs
continue to work.

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Reorganize sidebar: HTTP APIs section, move Connect Metrics & CRDs

- Move Connect Metrics and CRDs Monitoring under Other Features
- Rename "Robusta Pro Features" to "HTTP APIs"
- Move Holmes Chat API from AI Analysis to HTTP APIs
- Rewrite robusta-pro-features.rst as HTTP APIs overview
- Add hidden toctree to metric-providers.rst for sub-pages
- All file paths unchanged so existing URLs keep working

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Remove stale Robusta Pro Features link, add Robusta Classic section

- Remove "Robusta Pro Features - Detailed breakdown" from Learn More
  (page was renamed to HTTP APIs)
- Add brief Robusta Classic section explaining the rule-based
  automation engine that predates HolmesGPT

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Link data sources to holmesgpt.dev, update signup link and Classic wording

- Replace inline data source lists with link to holmesgpt.dev/data-sources/
- Point "Get started" to platform.robusta.dev/signup instead of install ref
- Soften Robusta Classic wording to "can be installed as part of"

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Simplify main-features page and clean up getting-started prerequisites

- Replace embedded videos and usage examples with link to home.robusta.dev
- Add signup link to Next Steps on main-features
- Remove "Robusta UI sink enabled" prerequisite from getting-started
- Link Robusta SaaS account prerequisite to signup page

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Simplify getting-started, link to holmesgpt.dev with robusta-helm-chart tab

- Change "GPT-4o" to "frontier models from Anthropic, OpenAI, and more"
- Remove Test Your Setup section
- Replace inline AI provider configs with link to holmesgpt.dev/ai-providers/
- Add ?tab=robusta-helm-chart to all holmesgpt.dev links (docs + conf.py redirects)
- Remove redundant note about Helm chart configuration sections

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Clean up docs: trim getting-started, fix sidebar, update README, remove pages

- Remove Common Issues and trim Next Steps in getting-started (keep only
  Configure Data Sources)
- Fix sidebar label: "Managed Prometheus Alerts" -> "Send Alerts to Robusta"
- Point GitHub Issue link to holmesgpt repo instead of robusta
- Update README: mark as Robusta Classic, add HolmesGPT link at top
- Remove Contributing page, docs-contributions, and Community Tutorials
- Update conf.py redirects for removed pages

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Fix GitHub link to HolmesGPT repo, fix Other Features sidebar flattening

- Change repo_url and social link in conf.py to holmesGPT repo
- Change Other Features toctree maxdepth from 4 to 1 so sub-pages
  nest under their parent (e.g. PagerDuty under Send Alerts to Robusta)
  instead of all appearing as flat top-level items

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Fix Other Features sidebar: remove hidden toctrees from parent pages

The sphinx_immaterial theme renders ALL pages from nested toctrees as
flat items in the sidebar nav, ignoring maxdepth. Fix by removing the
hidden toctree directives from parent pages under Other Features:
- configuration/index.rst (Send Alerts to Robusta)
- notification-routing/configuring-sinks.rst (Notification Sinks)
- notification-routing/index.rst (Alert Routing)
- playbook-reference/index.rst (Playbooks)
- track-changes/kubernetes-changes.rst (Track Config Changes)
- configuration/metric-providers.rst (Connect Metrics)

Child pages remain accessible via in-page content links and grid cards.
Also suppress toc.excluded warnings for these now-orphaned child pages.

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Fix architecture pages to appear in sidebar TOC hierarchy

Create how-it-works/index.rst as a parent container with toctree
so that Architecture and Open Source vs SaaS pages appear nested
under "Overview" in the sidebar, matching the pattern used by
GitOps > ArgoCD. Previously they were listed flat as orphan pages.

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Clean up README header and move nav links under What Can Robusta Do

Remove subtitle and HolmesGPT callout from header. Move navigation
links (How it Works, Installation, etc.) under the What Can Robusta
Do section.

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Add toctree to configuration/index.rst and trim oss-vs-saas text

Add hidden toctree listing all alertmanager-integration child pages
so they appear properly in the sidebar navigation. Remove extra
HolmesGPT sentence from oss-vs-saas page.

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Revert suppress_warnings to original value

Remove toc.excluded and toc.not_readable from suppress_warnings
so these warnings surface during builds.

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Fix RST heading underline length for cluster_name section

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Fix Other Features sidebar nesting for Send Alerts to Robusta

Move toctree to end of configuration/index.rst (after content) to
match the pattern used by gitops/index.rst. When the toctree was
before the heading, Sphinx rendered children as flat siblings.
With toctree after content, alertmanager pages now nest properly
under "Send Alerts to Robusta" in the sidebar.

Also set Other Features maxdepth to 4 to allow deep nesting.

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Move toctree before section headings in configuration/index

Section headings (Prometheus & AlertManager, Other, Advanced) after
the toctree caused Sphinx to nest toctree children under the last
section in the sidebar. Moving the toctree before the headings (like
actions/index.rst already does) keeps children flat under the page
title while preserving proper RST section headings.

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Add toctrees for sidebar children and fix missing pages

- Remove stale "Looking to get push notifications" note from
  kubernetes-changes.rst
- Add LaunchDarkly to configuration/index.rst toctree and grid
- Add toctree to configuring-sinks.rst so individual sink pages
  (Slack, Teams, PagerDuty, etc.) appear as sidebar children
- Add toctree to notification-routing/index.rst so routing pages
  appear as sidebar children under Alert Routing
- Add toctree to playbook-reference/index.rst so sub-sections
  appear as sidebar children under Playbooks

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Move LaunchDarkly under Track Config Changes to match master

LaunchDarkly was originally a child of Track Config Changes on master,
not Send Alerts. Move it there by adding a toctree to
kubernetes-changes.rst and removing it from configuration/index.rst.

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Flatten Overview section: remove double Overview in sidebar

Replace how-it-works/index with its children (architecture,
oss-vs-saas) directly in the root toctree so they appear as
siblings of Welcome to Robusta instead of nested under a
duplicate Overview entry.

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Update OSS description: CLI and HTTP API, no web UI

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Update oss-vs-saas: remove pro link, CNCF sandbox, simplify classic

- Remove link to pro features from "complete feature set" text
- Change MIT licensed to CNCF sandbox project
- Simplify Robusta Classic migration paragraph

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Rename AI Analysis section to SRE Agent

Update sidebar caption and cross-reference in playbook-reference.

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

* Point Get Started button to signup page

Change the Get Started link on the index page from the local
installation docs to the platform signup URL.

https://claude.ai/code/session_0184fwhrjC4ELrYQBMCbyhfS

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: aantn

README.md

@@ -1,19 +1,21 @@
 <div id="top"></div>
 
 <div align="center">
-  <h1 align="center">Robusta - Better Prometheus Notifications for Kubernetes</h1>
-  <h2 align="center">Better grouping, enrichment, and remediation of your existing alerts</h2>
-  <p align="center">
-    <a href="#%EF%B8%8F-how-it-works"><strong>How it Works</strong></a> |
-    <a href="#-installing-robusta"><strong>Installation</strong></a> |
-    <a href="https://docs.robusta.dev/master/configuration/index.html"><strong>Integrations ↗</strong></a> |
-    <a href="https://docs.robusta.dev/master/index.html"><strong>Docs ↗</strong></a> |
-    <a href="https://bit.ly/robusta-slack"><strong>Slack Community ↗</strong></a>
-  </p>
+  <h1 align="center">Robusta Classic - Prometheus Alert Enrichment for Kubernetes</h1>
 </div>
 
+> **Note:** This repository contains **Robusta Classic** — the rule-based alert enrichment engine. For AI-powered root cause analysis, see [HolmesGPT](https://github.com/robusta-dev/holmesgpt). Both can be installed together as part of the [Robusta platform](https://platform.robusta.dev/signup).
+
 ## What Can Robusta Do?
 
+<p align="center">
+  <a href="#%EF%B8%8F-how-it-works"><strong>How it Works</strong></a> |
+  <a href="#-installing-robusta"><strong>Installation</strong></a> |
+  <a href="https://docs.robusta.dev/master/configuration/index.html"><strong>Integrations ↗</strong></a> |
+  <a href="https://docs.robusta.dev/master/index.html"><strong>Docs ↗</strong></a> |
+  <a href="https://bit.ly/robusta-slack"><strong>Slack Community ↗</strong></a>
+</p>
+
 Compatible with kube-prometheus-stack, Prometheus Operator, and more.
 
 Robusta integrates with Prometheus by webhook and adds features like:

docs/community-tutorials.rst

@@ -109,7 +109,7 @@
     "tutorials/routing-silencing.html": "/master/notification-routing/routing-silencing.html",
     "configuration/configuring-sinks.html": "/master/notification-routing/configuring-sinks.html",
     "how-it-works/privacy-and-security.html": "/master/setup-robusta/privacy-and-security.html",
-    "how-it-works/index.html": "/master/playbook-reference/what-are-playbooks.html",
+    # "how-it-works/index.html": "/master/playbook-reference/what-are-playbooks.html",  # removed: now a real page
     "playbook-reference/examples.html": "/master/playbook-reference/builtin-alert-enrichment.html",
     "playbook-reference/prometheus-examples/index.html": "/master/playbook-reference/builtin-alert-enrichment.html",
     "tutorials/playbook-track-changes.html": "/master/playbook-reference/kubernetes-examples/kubernetes-change-notifications.html",
@@ -133,35 +133,35 @@
     "configuration/ai-analysis.html": "/master/configuration/holmesgpt/main-features.html",
     "configuration/holmesgpt/index.html": "/master/configuration/holmesgpt/main-features.html",
     # AI Analysis pages redirects to holmesgpt.dev (docs have moved there)
-    "configuration/holmesgpt/builtin_toolsets.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/",
-    "configuration/holmesgpt/permissions.html": "https://holmesgpt.dev/data-sources/permissions/",
-    "configuration/holmesgpt/custom_toolsets.html": "https://holmesgpt.dev/data-sources/custom-toolsets/",
-    "configuration/holmesgpt/remote_mcp_servers.html": "https://holmesgpt.dev/data-sources/remote-mcp-servers/",
+    "configuration/holmesgpt/builtin_toolsets.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/?tab=robusta-helm-chart",
+    "configuration/holmesgpt/permissions.html": "https://holmesgpt.dev/data-sources/permissions/?tab=robusta-helm-chart",
+    "configuration/holmesgpt/custom_toolsets.html": "https://holmesgpt.dev/data-sources/custom-toolsets/?tab=robusta-helm-chart",
+    "configuration/holmesgpt/remote_mcp_servers.html": "https://holmesgpt.dev/data-sources/remote-mcp-servers/?tab=robusta-helm-chart",
     # Individual toolset page redirects
-    "configuration/holmesgpt/toolsets/argocd.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/argocd/",
-    "configuration/holmesgpt/toolsets/aws.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/aws/",
-    "configuration/holmesgpt/toolsets/confluence.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/confluence/",
-    "configuration/holmesgpt/toolsets/coralogix_logs.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/coralogix-logs/",
-    "configuration/holmesgpt/toolsets/datadog_logs.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/datadog/",
-    "configuration/holmesgpt/toolsets/datetime.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/datetime/",
-    "configuration/holmesgpt/toolsets/docker.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/docker/",
-    "configuration/holmesgpt/toolsets/grafanaloki.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/grafanaloki/",
-    "configuration/holmesgpt/toolsets/grafanatempo.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/grafanatempo/",
-    "configuration/holmesgpt/toolsets/helm.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/helm/",
-    "configuration/holmesgpt/toolsets/internet.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/internet/",
-    "configuration/holmesgpt/toolsets/kafka.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/kafka/",
-    "configuration/holmesgpt/toolsets/kubernetes.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/kubernetes/",
-    "configuration/holmesgpt/toolsets/newrelic.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/newrelic/",
-    "configuration/holmesgpt/toolsets/notion.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/notion/",
-    "configuration/holmesgpt/toolsets/opensearch_logs.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/opensearch-logs/",
-    "configuration/holmesgpt/toolsets/opensearch_status.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/opensearch-status/",
-    "configuration/holmesgpt/toolsets/prometheus.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/prometheus/",
-    "configuration/holmesgpt/toolsets/rabbitmq.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/rabbitmq/",
-    "configuration/holmesgpt/toolsets/robusta.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/robusta/",
-    "configuration/holmesgpt/toolsets/slab.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/slab/",
+    "configuration/holmesgpt/toolsets/argocd.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/argocd/?tab=robusta-helm-chart",
+    "configuration/holmesgpt/toolsets/aws.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/aws/?tab=robusta-helm-chart",
+    "configuration/holmesgpt/toolsets/confluence.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/confluence/?tab=robusta-helm-chart",
+    "configuration/holmesgpt/toolsets/coralogix_logs.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/coralogix-logs/?tab=robusta-helm-chart",
+    "configuration/holmesgpt/toolsets/datadog_logs.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/datadog/?tab=robusta-helm-chart",
+    "configuration/holmesgpt/toolsets/datetime.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/datetime/?tab=robusta-helm-chart",
+    "configuration/holmesgpt/toolsets/docker.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/docker/?tab=robusta-helm-chart",
+    "configuration/holmesgpt/toolsets/grafanaloki.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/grafanaloki/?tab=robusta-helm-chart",
+    "configuration/holmesgpt/toolsets/grafanatempo.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/grafanatempo/?tab=robusta-helm-chart",
+    "configuration/holmesgpt/toolsets/helm.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/helm/?tab=robusta-helm-chart",
+    "configuration/holmesgpt/toolsets/internet.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/internet/?tab=robusta-helm-chart",
+    "configuration/holmesgpt/toolsets/kafka.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/kafka/?tab=robusta-helm-chart",
+    "configuration/holmesgpt/toolsets/kubernetes.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/kubernetes/?tab=robusta-helm-chart",
+    "configuration/holmesgpt/toolsets/newrelic.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/newrelic/?tab=robusta-helm-chart",
+    "configuration/holmesgpt/toolsets/notion.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/notion/?tab=robusta-helm-chart",
+    "configuration/holmesgpt/toolsets/opensearch_logs.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/opensearch-logs/?tab=robusta-helm-chart",
+    "configuration/holmesgpt/toolsets/opensearch_status.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/opensearch-status/?tab=robusta-helm-chart",
+    "configuration/holmesgpt/toolsets/prometheus.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/prometheus/?tab=robusta-helm-chart",
+    "configuration/holmesgpt/toolsets/rabbitmq.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/rabbitmq/?tab=robusta-helm-chart",
+    "configuration/holmesgpt/toolsets/robusta.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/robusta/?tab=robusta-helm-chart",
+    "configuration/holmesgpt/toolsets/slab.html": "https://holmesgpt.dev/data-sources/builtin-toolsets/slab/?tab=robusta-helm-chart",
     "coverage.html": "/master/how-it-works/coverage.html",
     "tutorials/python-profiling.html": "/master/playbook-reference/actions/python-troubleshooting.html#python-profiler",
-    "tutorials/more-tutorials.html": "/master/community-tutorials.html",
+    "tutorials/more-tutorials.html": "/master/help.html",
     "common-errors.html": "/master/help.html#common-errors",
     "user-guide/defining-playbooks.html": "/master/playbook-reference/defining-playbooks/index.html",
     "user-guide/global-config.html": "/master/setup-robusta/additional-settings.html#global-config",
@@ -201,10 +201,10 @@
     "developer-guide/actions/triggers-and-events.html": "/master/playbook-reference/actions/develop-actions/triggers-and-events.html",
     "developer-guide/actions/utility-functions.html": "/master/playbook-reference/actions/develop-actions/utility-functions.html",
     "developer-guide/actions/documenting-actions.html": "/master/playbook-reference/actions/develop-actions/documenting-actions.html",
-    "developer-guide/platform/index.html": "/master/contributing.html",
-    "developer-guide/platform/dev-setup.html": "/master/contributing.html",
-    "developer-guide/platform/coding-conventions.html": "/master/contributing.html",
-    "developer-guide/platform/docs-contributions.html": "/master/docs-contributions.html#improving-these-docs",
+    "developer-guide/platform/index.html": "/master/help.html",
+    "developer-guide/platform/dev-setup.html": "/master/help.html",
+    "developer-guide/platform/coding-conventions.html": "/master/help.html",
+    "developer-guide/platform/docs-contributions.html": "/master/help.html",
     "developer-guide/platform/sinks-guide.html": "/master/configuration/sinks/sinks-development.html",
     "user-guide/robusta-cli.html": "/master/setup-robusta/installation/index.html",
     "advanced/index.html": "/master/setup-robusta/installation/index.html",
@@ -293,8 +293,8 @@
     "icon": {
         "repo": "fontawesome/brands/github",
     },
-    "repo_url": "https://github.com/robusta-dev/robusta",
-    "repo_name": "Robusta",
+    "repo_url": "https://github.com/robusta-dev/holmesGPT",
+    "repo_name": "HolmesGPT",
     "repo_type": "github",
     "edit_uri": "tree/master/docs",
     "palette": [
@@ -330,7 +330,7 @@
     "social": [
         {
             "icon": "fontawesome/brands/github",
-            "link": "https://github.com/robusta-dev/robusta",
+            "link": "https://github.com/robusta-dev/holmesGPT",
         },
         {
             "icon": "fontawesome/brands/slack",

docs/conf.py

@@ -48,7 +48,7 @@ Apply the following Secret in the GMP namespace (default ``gmp-public``). Replac
          repeat_interval: 4h
 
 Ensure alerts include ``cluster_name``
-*************************************
+**************************************
 
 Use an ``OperatorConfig`` to add external labels to both collection and rule evaluation so every alert contains the required ``cluster_name`` label.
 

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

@@ -1,78 +1,32 @@
-Overview
-========
+HTTP APIs
+=========
 
 .. note::
-    These features are available with the Robusta SaaS platform and self-hosted commercial plans. They are not available in the open-source version.
+    These APIs are available with the Robusta SaaS platform and self-hosted commercial plans. They are not available in the open-source version.
 
-Robusta Pro adds a web UI, additional integrations, and enterprise APIs to the open-source engine. Available as SaaS (we handle hosting) or self-hosted on-premise.
+The Robusta Platform exposes REST APIs for programmatic access to alerts, investigations, and platform data.
 
-AI Analysis
------------
-
-Automatically investigate and resolve issues with AI-powered analysis.
-
-:doc:`AI Analysis (HolmesGPT) <../holmesgpt/main-features>`
-    Automatically analyze Kubernetes alerts, logs, and metrics. Get potential root causes and remediation suggestions.
+Holmes Chat API
+---------------
 
 :doc:`Holmes Chat API <../holmesgpt/holmes-chat-api>`
-    Programmatically send questions to Holmes AI for root cause analysis via REST API.
-
-Custom Alert Ingestion
------------------------
-
-Send alerts to Robusta from any monitoring system using HTTP webhooks.
-
-:doc:`Custom Webhooks <custom-webhooks>`
-    Send alerts from any system that supports HTTP webhooks, including custom monitoring solutions.
-
-:doc:`New Relic Integration <../alertmanager-integration/newrelic>`
-    Forward alerts from New Relic to Robusta via webhooks.
-
-:doc:`LaunchDarkly Integration <../alertmanager-integration/launchdarkly>`
-    Forward feature flag changes from LaunchDarkly to Robusta via webhooks.
-
-:doc:`SolarWinds Integration <../alertmanager-integration/solarwinds>`
-    Configure SolarWinds to send alert webhooks directly to Robusta.
+    Send questions to HolmesGPT for on-demand root cause analysis via REST.
 
-:doc:`Nagios Integration <../alertmanager-integration/nagios>`
-    Forward alerts from Nagios to Robusta for enrichment and automation.
-
-Data Export and Reporting APIs
--------------------------------
-
-Export alert history and generate reports using Robusta's REST APIs.
-
-**Robusta API Reference**
-    Comprehensive APIs for exporting alert history, generating reports, and sending custom alerts programmatically.
-
-Features include:
+Data Export and Reporting
+-------------------------
 
 * :doc:`Alert Export API <alert-export-api>`: Export historical alert data with filtering by time range, alert name, and account
 * :doc:`Alert Reporting API <alert-statistics-api>`: Get aggregated statistics and counts for different alert types
-* :doc:`Send Alerts API <send-alerts-api>`: Send alerts programmatically from external systems or via integrations
+* :doc:`Send Alerts API <send-alerts-api>`: Send alerts programmatically from external systems
 * :doc:`Configuration Changes API <configuration-changes-api>`: Track configuration changes in your environment
+* :doc:`Namespace Resources API <namespace-resources-api>`: Query namespace-level resource information
 * :doc:`RBAC Configuration API <rbac-api>`: Programmatically manage role-based access control configurations
 * :doc:`Prometheus Query API <prometheus-query-api>`: Run PromQL queries against Prometheus in your connected clusters
 
-Additional Pro Features
------------------------
-
-Additional capabilities in Robusta Pro:
-
-* **Web UI**: Manage alerts, playbooks, and configuration through a browser interface
-* **Alert Templates**: Create Prometheus alerts without writing PromQL
-* **Historical Data**: Query alert history and trends
-* **Enterprise Support**: Production support and SLA options
-
-For more details on the differences between open-source and SaaS, see :doc:`Open Source vs SaaS <../../how-it-works/oss-vs-saas>`.
-
 Getting Started
 ---------------
 
-To access these features:
-
-1. **Robusta SaaS**: `Sign up for free <https://platform.robusta.dev/signup>`_ to get started with the full platform
-2. **Self-hosted Commercial**: Contact support@robusta.dev for enterprise plans with self-hosted UI
-3. **API Access**: Generate API keys in the Robusta platform under **Settings** → **API Keys**
+To access these APIs:
 
-For detailed API documentation and examples, see the individual API references listed above.
+1. `Sign up <https://platform.robusta.dev/signup>`_ for Robusta SaaS or contact support@robusta.dev for self-hosted plans
+2. Generate API keys in the Robusta Platform under **Settings** → **API Keys**