Commit 4105732
More doc improvements (#1890)
* docs: reorganize integrations page to focus on alert forwarding
- Remove sinks/destinations from integrations overview
- Restructure page to highlight "Forward Alerts to Robusta"
- Add dedicated section for Prometheus, Nagios, and SolarWinds
- Simplify description to focus on alert forwarding and AI analysis
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* docs: move sinks from Integrations to Notifications & Routing section
- Move sinks reference from Integrations nav to Notifications & Routing nav
- Place sinks as first item in Notifications & Routing section
- Remove sinks from Integrations section to reduce confusion
- Keep logical grouping of alert destinations with notification routing
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* docs: fix integration page hierarchy and remove redundancy
- Redesign integrations overview to be truly high-level with categories
- Rename "Integrating with Prometheus" to "Alert Sources" for broader scope
- Remove duplicate content between overview and subpages
- Focus overview on integration categories rather than detailed setup
- Update navigation labels to match new page structure
- Make user journey clearer: overview → specific alert source setup
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* docs: major reorganization - separate Alert Sources, AI Analysis, and Automation
- Rename "Integrations" section to "Alert Sources" - much clearer purpose
- Create dedicated "AI Analysis" section for Holmes GPT only
- Move KRR, Popeye, and data export to "Automation" section
- Update Alert Sources overview to focus purely on monitoring integrations
- Remove mixed content categories that confused users
- Improve logical flow: Alert Sources → AI Analysis → Notifications → Automation
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* docs: improve notifications navigation with proper hierarchy
- Create new notifications overview page as entry point
- Reorder navigation: Overview → Configuring Sinks → Sink Reference
- Fix information hierarchy so users start with concepts, not specific sinks
- Prevent sphinx menu expansion pushing basic setup pages down
- Add clear getting started flow and common workflows
- Update sink reference title to match new structure
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* docs: move Nagios and SolarWinds to top-level Alert Sources
- Move Nagios and SolarWinds from Prometheus subpages to top-level Alert Sources
- Remove confusing navigation hierarchy where non-Prometheus systems appeared under Prometheus
- Clean up Prometheus page to focus purely on Prometheus/AlertManager integrations
- Remove "Other Alerting Systems" section since they're now top-level
- Create clearer navigation: Overview → Prometheus → Nagios → SolarWinds
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* docs: make Alert Sources overview more concise and actionable
- Remove verbose explanations and get straight to the point
- Lead with clear action: "Choose your monitoring system"
- Make card descriptions more direct and useful
- Add practical note about webhook compatibility for other systems
- Cut word count by ~60% while improving clarity
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* docs: remove negative labels like 'legacy' and 'enterprise'
- Change 'Legacy systems' to 'Nagios monitoring'
- Change 'Enterprise monitoring' to 'SolarWinds monitoring'
- Keep descriptions neutral and product-focused
- Avoid terms that might make users feel bad about their tech choices
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* docs: add helpful link to webhook documentation for other systems
- Link 'HTTP webhooks' to webhook triggers documentation
- Provides users with concrete next steps if their system isn't listed
- Makes the fallback option actionable rather than just informational
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* docs: fix webhook link to point to correct API documentation
- Link HTTP webhooks to exporting-data.rst which contains POST /api/alerts endpoint
- This is the correct endpoint for sending alerts from any system via HTTP
- Previous link was to webhook triggers which is for different use case
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* docs: move webhook API to Alert Sources section where it belongs
- Move exporting-data.rst from Automation to Alert Sources as "Custom Webhooks"
- This contains the POST /api/alerts endpoint for sending alerts TO Robusta
- Makes it discoverable for users wanting to integrate custom monitoring systems
- Logical placement with other alert source integrations
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* docs: switch from horizontal tabs to left sidebar navigation
- Remove navigation.tabs and navigation.tabs.sticky features
- Add navigation.sections and navigation.expand for better sidebar
- This provides more room for additional top-level sections
- Makes navigation more scalable for future section additions
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* switch to sidebar navigation
* clarify on pro features
* put robusta pro features in the right place
* docs
* Update index.rst
* fixes
* Update disable-oomkill-notifications.rst
* Update alert-builtin-enrichment.rst
* revert changes
* small sphinx fixes
* unify prometheus terminology
* Update alert-custom-prometheus.rst
* Update index.rst
* Update index.rst
---------
Co-authored-by: Claude <noreply@anthropic.com>1 parent 5124e21 commit 4105732
22 files changed
Lines changed: 75 additions & 88 deletions
File tree
- docs
- configuration
- alertmanager-integration
- holmesgpt
- toolsets
- sinks
- how-it-works
- notification-routing
- playbook-reference
- actions
- kubernetes-examples
- setup-robusta/installation
Lines changed: 20 additions & 22 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
23 | 23 | | |
24 | 24 | | |
25 | 25 | | |
26 | | - | |
| 26 | + | |
27 | 27 | | |
28 | | - | |
| 28 | + | |
29 | 29 | | |
30 | | - | |
31 | | - | |
32 | | - | |
33 | | - | |
34 | | - | |
35 | | - | |
36 | | - | |
37 | | - | |
38 | | - | |
39 | | - | |
40 | | - | |
41 | | - | |
42 | | - | |
43 | | - | |
44 | | - | |
45 | | - | |
46 | | - | |
47 | | - | |
48 | | - | |
| 30 | + | |
49 | 31 | | |
| 32 | + | |
50 | 33 | | |
51 | 34 | | |
52 | 35 | | |
53 | 36 | | |
54 | 37 | | |
55 | 38 | | |
56 | | - | |
| 39 | + | |
| 40 | + | |
| 41 | + | |
| 42 | + | |
| 43 | + | |
| 44 | + | |
| 45 | + | |
| 46 | + | |
| 47 | + | |
| 48 | + | |
| 49 | + | |
| 50 | + | |
| 51 | + | |
| 52 | + | |
| 53 | + | |
| 54 | + | |
57 | 55 | | |
58 | 56 | | |
59 | 57 | | |
| |||
Lines changed: 1 addition & 1 deletion
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
7 | 7 | | |
8 | 8 | | |
9 | 9 | | |
10 | | - | |
| 10 | + | |
11 | 11 | | |
12 | 12 | | |
13 | 13 | | |
| |||
Lines changed: 1 addition & 1 deletion
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
54 | 54 | | |
55 | 55 | | |
56 | 56 | | |
57 | | - | |
| 57 | + | |
58 | 58 | | |
Lines changed: 4 additions & 4 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
9 | 9 | | |
10 | 10 | | |
11 | 11 | | |
12 | | - | |
13 | | - | |
14 | | - | |
15 | | - | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
16 | 16 | | |
17 | 17 | | |
18 | 18 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
28 | 28 | | |
29 | 29 | | |
30 | 30 | | |
31 | | - | |
| 31 | + | |
32 | 32 | | |
33 | 33 | | |
34 | 34 | | |
35 | 35 | | |
36 | | - | |
| 36 | + | |
37 | 37 | | |
38 | 38 | | |
39 | 39 | | |
40 | 40 | | |
41 | | - | |
42 | | - | |
43 | | - | |
44 | | - | |
45 | | - | |
46 | 41 | | |
47 | 42 | | |
48 | 43 | | |
49 | 44 | | |
50 | 45 | | |
51 | | - | |
| 46 | + | |
52 | 47 | | |
53 | | - | |
| 48 | + | |
54 | 49 | | |
55 | 50 | | |
56 | 51 | | |
57 | 52 | | |
58 | 53 | | |
59 | 54 | | |
60 | 55 | | |
| 56 | + | |
| 57 | + | |
| 58 | + | |
| 59 | + | |
| 60 | + | |
61 | 61 | | |
62 | 62 | | |
63 | 63 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
74 | 74 | | |
75 | 75 | | |
76 | 76 | | |
77 | | - | |
| 77 | + | |
78 | 78 | | |
79 | 79 | | |
80 | 80 | | |
| |||
Lines changed: 2 additions & 2 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | | - | |
| 1 | + | |
2 | 2 | | |
3 | 3 | | |
4 | 4 | | |
| |||
50 | 50 | | |
51 | 51 | | |
52 | 52 | | |
53 | | - | |
| 53 | + | |
54 | 54 | | |
55 | 55 | | |
56 | 56 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
281 | 281 | | |
282 | 282 | | |
283 | 283 | | |
| 284 | + | |
284 | 285 | | |
285 | 286 | | |
286 | 287 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
15 | 15 | | |
16 | 16 | | |
17 | 17 | | |
18 | | - | |
| 18 | + | |
19 | 19 | | |
20 | 20 | | |
21 | 21 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
3 | 3 | | |
4 | | - | |
| 4 | + | |
5 | 5 | | |
6 | 6 | | |
7 | 7 | | |
| |||
0 commit comments