Skip to content

Commit f3dfb0e

Browse files
committed
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
1 parent c9d3e83 commit f3dfb0e

7 files changed

Lines changed: 2 additions & 97 deletions

File tree

docs/conf.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@
5656
"sphinx_reredirects",
5757
]
5858

59-
suppress_warnings = ["autosectionlabel.*"]
59+
suppress_warnings = ["autosectionlabel.*", "toc.excluded", "toc.not_readable"]
6060

6161
# sphinx redirects from old docs
6262

docs/configuration/index.rst

Lines changed: 0 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,5 @@
11
:hide-toc:
22

3-
.. toctree::
4-
:hidden:
5-
6-
alertmanager-integration/outofcluster-prometheus
7-
alertmanager-integration/alert-manager
8-
alertmanager-integration/eks-managed-prometheus
9-
alertmanager-integration/azure-managed-prometheus
10-
alertmanager-integration/coralogix_managed_prometheus
11-
alertmanager-integration/dynatrace
12-
alertmanager-integration/embedded-prometheus
13-
alertmanager-integration/google-managed-prometheus
14-
alertmanager-integration/gcp-monitoring
15-
alertmanager-integration/google-managed-alertmanager
16-
alertmanager-integration/grafana-self-hosted
17-
alertmanager-integration/grafana-cloud
18-
alertmanager-integration/nagios
19-
alertmanager-integration/newrelic
20-
alertmanager-integration/pagerduty-alerting
21-
alertmanager-integration/solarwinds
22-
alertmanager-integration/victoria-metrics
23-
alertmanager-integration/customize-labels-priorities
24-
exporting/custom-webhooks
25-
263
Send Alerts to Robusta
274
=======================
285

docs/configuration/metric-providers.rst

Lines changed: 0 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,5 @@
11
:hide-toc:
22

3-
.. toctree::
4-
:hidden:
5-
6-
metric-providers-in-cluster
7-
metric-providers-external
8-
metric-providers-azure
9-
metric-providers-aws
10-
metric-providers-google
11-
metric-providers-coralogix
12-
metric-providers-victoria
13-
metric-providers-grafana-cloud
14-
153
General Settings
164
================
175

docs/notification-routing/configuring-sinks.rst

Lines changed: 1 addition & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,6 @@
11
.. _sinks-overview:
22

3-
.. toctree::
4-
:hidden:
5-
6-
../configuration/sinks/index
7-
../configuration/sinks/slack
8-
../configuration/sinks/ms-teams
9-
../configuration/sinks/RobustaUI
10-
../configuration/sinks/mail
11-
../configuration/sinks/telegram
12-
../configuration/sinks/discord
13-
../configuration/sinks/DataDog
14-
../configuration/sinks/mattermost
15-
../configuration/sinks/Opsgenie
16-
../configuration/sinks/PagerDuty
17-
../configuration/sinks/VictorOps
18-
../configuration/sinks/YandexMessenger
19-
../configuration/sinks/jira
20-
../configuration/sinks/webhook
21-
../configuration/sinks/file
22-
../configuration/sinks/webex
23-
../configuration/sinks/kafka
24-
../configuration/sinks/rocketchat
25-
../configuration/sinks/google_chat
26-
../configuration/sinks/pushover
27-
../configuration/sinks/ServiceNow
28-
../configuration/sinks/zulip
29-
../configuration/sinks/sinks-development
3+
304

315
Defining Sinks
326
==========================

docs/notification-routing/index.rst

Lines changed: 0 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,5 @@
11
:hide-toc:
22

3-
.. toctree::
4-
:hidden:
5-
6-
routing-with-scopes
7-
notification-grouping
8-
routing-by-time
9-
routing-by-namespace
10-
routing-by-type
11-
implementing-monitoring-shifts
12-
routing-to-multiple-slack-channels
13-
routing-exclusion
14-
routing-by-severity
15-
excluding-resolved
16-
disable-oomkill-notifications
17-
routing-silencing
18-
193
Notifications & Routing Overview
204
=================================
215

docs/playbook-reference/index.rst

Lines changed: 0 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,6 @@
11
.. _customPlaybooks:
22
.. _Playbook Basics:
33

4-
.. toctree::
5-
:hidden:
6-
7-
defining-playbooks/creating-notifications
8-
builtin-alert-enrichment
9-
automatic-remediation-examples/index
10-
kubernetes-examples/kubernetes-change-notifications
11-
defining-playbooks/silencer-playbooks
12-
logs-triggers/index
13-
../configuration/resource-recommender
14-
triggers/index
15-
actions/index
16-
174
Playbooks Basics
185
##################
196

docs/track-changes/kubernetes-changes.rst

Lines changed: 0 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,3 @@
1-
.. toctree::
2-
:hidden:
3-
4-
../configuration/alertmanager-integration/launchdarkly
5-
61
Kubernetes Changes
72
==================
83

0 commit comments

Comments
 (0)