From 7240b68d6839d585db4e03c408518992d214bce6 Mon Sep 17 00:00:00 2001 From: Stacey Salamon Date: Tue, 17 Mar 2026 18:23:14 +0100 Subject: [PATCH 1/6] update: navigation --- docs/platform/howto/list-service.md | 1 + docusaurus.config.ts | 152 +++++++++++++- sidebars.ts | 300 ++++++++++++++-------------- 3 files changed, 297 insertions(+), 156 deletions(-) diff --git a/docs/platform/howto/list-service.md b/docs/platform/howto/list-service.md index 825c4a92f..b5b3d2e41 100644 --- a/docs/platform/howto/list-service.md +++ b/docs/platform/howto/list-service.md @@ -1,5 +1,6 @@ --- title: Service management +sidebar_label: Overview --- import DocCardList from '@theme/DocCardList'; diff --git a/docusaurus.config.ts b/docusaurus.config.ts index 67cb7adc0..b47def64a 100644 --- a/docusaurus.config.ts +++ b/docusaurus.config.ts @@ -177,24 +177,154 @@ const config: Config = { }, items: [ { - label: 'Console', + type: 'dropdown', position: 'left', - href: 'https://console.aiven.io/login', + label: 'Platform', + to: '/docs/get-started', + items: [ + { + type: 'doc', + docId: 'get-started', + label: 'Get started', + }, + { + type: 'doc', + docId: 'platform/concepts/orgs-units-projects', + label: 'Organizations, units, and projects', + }, + { + type: 'doc', + docId: 'platform/concepts/billing-and-payment', + label: 'Billing and payment', + }, + { + type: 'doc', + docId: 'platform/concepts/user-access-management', + label: 'User and access management', + }, + { + type: 'doc', + docId: 'platform/howto/list-authentication', + label: 'Authentication', + }, + { + type: 'doc', + docId: 'platform/howto/list-identity-providers', + label: 'Identity providers and domains', + }, + { + type: 'doc', + docId: 'platform/concepts/cloud-security', + label: 'Networking and security', + }, + ], }, { - label: 'API reference', + type: 'dropdown', position: 'left', - href: 'https://api.aiven.io/doc/', + label: 'Services', + to: '/docs/products/services', + items: [ + { + type: 'doc', + docId: 'products/flink', + label: 'Apache Flink®', + }, + { + type: 'doc', + docId: 'products/kafka', + + label: 'Apache Kafka®', + }, + { + type: 'doc', + docId: 'products/clickhouse', + label: 'ClickHouse®', + }, + { + type: 'doc', + docId: 'products/dragonfly', + label: 'Dragonfly', + }, + { + type: 'doc', + docId: 'products/grafana', + label: 'Grafana®', + }, + { + type: 'doc', + docId: 'products/metrics', + label: 'Metrics', + }, + { + type: 'doc', + docId: 'products/mysql', + label: 'MySQL®', + }, + { + type: 'doc', + docId: 'products/opensearch', + label: 'OpenSearch®', + }, + { + type: 'doc', + docId: 'products/postgresql', + label: 'PostgreSQL®', + }, + { + type: 'doc', + docId: 'products/valkey', + label: 'Valkey™', + }, + { + type: 'doc', + docId: 'platform/howto/list-service', + label: 'Service management', + }, + { + type: 'doc', + docId: 'platform/concepts/service-integration', + label: 'Service integrations', + }, + ], }, { - label: 'Changelog', - href: 'https://aiven.io/changelog', + type: 'dropdown', position: 'left', + label: 'Tools', + to: '/docs/tools', + items: [ + { + type: 'doc', + docId: 'tools/api', + label: 'API', + }, + { + type: 'doc', + docId: 'tools/terraform', + label: 'Terraform Provider', + }, + { + type: 'doc', + docId: 'tools/kubernetes', + label: 'Kubernetes Operator', + }, + { + type: 'doc', + docId: 'tools/cli', + label: 'CLI', + }, + { + type: 'doc', + docId: 'tools/query-optimizer', + label: 'SQL query optimizer', + }, + ], }, { - href: 'https://github.com/aiven/aiven-docs', - label: 'GitHub', - position: 'left', + label: 'Aiven Console', + position: 'right', + href: 'https://console.aiven.io/login', }, { type: 'search', @@ -265,6 +395,10 @@ const config: Config = { label: 'Support tiers', href: 'https://aiven.io/support-services', }, + { + label: 'Product updates', + href: 'https://aiven.io/changelog', + }, { label: 'Status', href: 'https://status.aiven.io', diff --git a/sidebars.ts b/sidebars.ts index 886a1ecb9..499ab0ed3 100644 --- a/sidebars.ts +++ b/sidebars.ts @@ -174,73 +174,6 @@ const sidebars: SidebarsConfig = { 'platform/howto/saml/add-onelogin-idp', ], }, - { - type: 'category', - label: 'Service management', - link: { - type: 'doc', - id: 'platform/howto/list-service', - }, - items: [ - { - type: 'category', - label: 'Concepts', - items: [ - 'platform/concepts/service-memory-limits', - 'platform/concepts/out-of-memory-conditions', - 'platform/concepts/maintenance-window', - 'platform/howto/custom-plans', - ], - }, - { - type: 'category', - label: 'Backup and restore', - items: [ - 'platform/concepts/service_backups', - 'platform/howto/restore_progress_updates', - { - type: 'category', - label: 'Backup to another region', - link: { - type: 'doc', - id: 'platform/concepts/backup-to-another-region', - }, - items: [ - 'platform/howto/btar/enable-backup-to-another-region', - 'platform/howto/btar/manage-backup-to-another-region', - 'platform/howto/btar/disable-backup-to-another-region', - ], - }, - ], - }, - { - type: 'category', - label: 'Migrations', - items: [ - 'platform/howto/migrate-services-cloud-region', - 'platform/howto/migrate-services-vpc', - ], - }, - { - type: 'category', - label: 'Service scaling', - items: [ - 'platform/howto/scale-services', - 'platform/howto/add-storage-space', - 'platform/howto/disk-autoscaler', - ], - }, - - 'platform/howto/create_new_service', - 'platform/concepts/service-power-cycle', - 'platform/concepts/rename-services', - 'platform/howto/tag-resources', - 'platform/howto/search-services', - 'platform/howto/create_new_service_user', - 'platform/concepts/service-forking', - 'platform/howto/prepare-for-high-load', - ], - }, { type: 'category', label: 'Networking and security', @@ -379,86 +312,9 @@ const sidebars: SidebarsConfig = { 'platform/reference/get-resource-IDs', ], }, - { - type: 'category', - label: 'Integrations', - className: 'expandedSection', - collapsed: false, - collapsible: false, - items: [ - 'platform/concepts/service-integration', - 'platform/howto/create-service-integration', - { - type: 'category', - label: 'Monitoring and logs', - link: { - type: 'doc', - id: 'platform/howto/list-monitoring', - }, - items: [ - { - type: 'category', - label: 'Amazon CloudWatch', - link: { - type: 'doc', - id: 'integrations/cloudwatch', - }, - items: [ - 'integrations/cloudwatch/cloudwatch-metrics', - { - type: 'category', - label: 'CloudWatch logs', - - items: [ - 'integrations/cloudwatch/cloudwatch-logs-console', - 'integrations/cloudwatch/cloudwatch-logs-cli', - ], - }, - ], - }, - { - type: 'category', - label: 'Datadog', - link: { - type: 'doc', - id: 'integrations/datadog', - }, - items: [ - 'integrations/datadog/datadog-metrics', - 'platform/howto/integrations/datadog-increase-metrics-limit', - 'integrations/datadog/datadog-logs', - 'integrations/datadog/add-custom-tags-to-datadog', - ], - }, - 'integrations/send-logs-to-elasticsearch', - 'integrations/cloudlogging', - { - type: 'category', - label: 'Remote Syslog', - link: { - type: 'doc', - id: 'integrations/rsyslog', - }, - items: [ - 'integrations/rsyslog/logtail', - 'integrations/rsyslog/loggly', - ], - }, - 'platform/howto/integrations/access-jmx-metrics-jolokia', - - { - type: 'category', - label: 'Prometheus', - link: { - id: 'platform/howto/integrations/prometheus-metrics', - type: 'doc', - }, - items: ['integrations/prometheus-system-metrics'], - }, - ], - }, - ], - }, + ], + // Tools sidebar + tools: [ { type: 'category', label: 'Aiven dev tools', @@ -528,6 +384,9 @@ const sidebars: SidebarsConfig = { 'tools/doc-diff-llms', ], }, + ], + //Services sidebar + services: [ { type: 'category', label: 'Services', @@ -2015,6 +1874,153 @@ const sidebars: SidebarsConfig = { }, ], }, + { + type: 'category', + label: 'Service management', + className: 'expandedSection', + collapsed: false, + collapsible: false, + items: [ + 'platform/howto/list-service', + { + type: 'category', + label: 'Concepts', + items: [ + 'platform/concepts/service-memory-limits', + 'platform/concepts/out-of-memory-conditions', + 'platform/concepts/maintenance-window', + 'platform/howto/custom-plans', + ], + }, + { + type: 'category', + label: 'Backup and restore', + items: [ + 'platform/concepts/service_backups', + 'platform/howto/restore_progress_updates', + { + type: 'category', + label: 'Backup to another region', + link: { + type: 'doc', + id: 'platform/concepts/backup-to-another-region', + }, + items: [ + 'platform/howto/btar/enable-backup-to-another-region', + 'platform/howto/btar/manage-backup-to-another-region', + 'platform/howto/btar/disable-backup-to-another-region', + ], + }, + ], + }, + { + type: 'category', + label: 'Migrations', + items: [ + 'platform/howto/migrate-services-cloud-region', + 'platform/howto/migrate-services-vpc', + ], + }, + { + type: 'category', + label: 'Service scaling', + items: [ + 'platform/howto/scale-services', + 'platform/howto/add-storage-space', + 'platform/howto/disk-autoscaler', + ], + }, + + 'platform/howto/create_new_service', + 'platform/concepts/service-power-cycle', + 'platform/concepts/rename-services', + 'platform/howto/tag-resources', + 'platform/howto/search-services', + 'platform/howto/create_new_service_user', + 'platform/concepts/service-forking', + 'platform/howto/prepare-for-high-load', + ], + }, + { + type: 'category', + label: 'Integrations', + className: 'expandedSection', + collapsed: false, + collapsible: false, + items: [ + 'platform/concepts/service-integration', + 'platform/howto/create-service-integration', + { + type: 'category', + label: 'Monitoring and logs', + link: { + type: 'doc', + id: 'platform/howto/list-monitoring', + }, + items: [ + { + type: 'category', + label: 'Amazon CloudWatch', + link: { + type: 'doc', + id: 'integrations/cloudwatch', + }, + items: [ + 'integrations/cloudwatch/cloudwatch-metrics', + { + type: 'category', + label: 'CloudWatch logs', + + items: [ + 'integrations/cloudwatch/cloudwatch-logs-console', + 'integrations/cloudwatch/cloudwatch-logs-cli', + ], + }, + ], + }, + { + type: 'category', + label: 'Datadog', + link: { + type: 'doc', + id: 'integrations/datadog', + }, + items: [ + 'integrations/datadog/datadog-metrics', + 'platform/howto/integrations/datadog-increase-metrics-limit', + 'integrations/datadog/datadog-logs', + 'integrations/datadog/add-custom-tags-to-datadog', + ], + }, + 'integrations/send-logs-to-elasticsearch', + 'integrations/cloudlogging', + { + type: 'category', + label: 'Remote Syslog', + link: { + type: 'doc', + id: 'integrations/rsyslog', + }, + items: [ + 'integrations/rsyslog/logtail', + 'integrations/rsyslog/loggly', + ], + }, + 'platform/howto/integrations/access-jmx-metrics-jolokia', + + { + type: 'category', + label: 'Prometheus', + link: { + id: 'platform/howto/integrations/prometheus-metrics', + type: 'doc', + }, + items: ['integrations/prometheus-system-metrics'], + }, + ], + }, + ], + }, ], }; From 65d637330cf7cfaf6da56db2239b0f6e8ef2a3ee Mon Sep 17 00:00:00 2001 From: Stacey Salamon Date: Tue, 17 Mar 2026 18:33:02 +0100 Subject: [PATCH 2/6] style dropdowns --- src/css/navbar.css | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/src/css/navbar.css b/src/css/navbar.css index 41ecee550..3d5a0cce8 100644 --- a/src/css/navbar.css +++ b/src/css/navbar.css @@ -51,3 +51,22 @@ .navbar__title { display: none; } + +/* Dropdown container */ +.navbar__item .dropdown__menu { + border: 1px solid var(--ifm-color-emphasis-200); + border-radius: 8px; + box-shadow: 0 4px 12px rgba(0, 0, 0, 0.1); + min-width: 200px; +} + +/* Dropdown links */ +.dropdown__link { + padding: 12px 16px; + font-weight: 500; +} + +.dropdown__link:hover { + background-color: var(--ifm-color-primary-lightest); + color: var(--ifm-color-primary); +} From 4d9cc52a1424009d0695b3ba3bc78e40d811e7c6 Mon Sep 17 00:00:00 2001 From: Stacey Salamon Date: Tue, 17 Mar 2026 19:01:01 +0100 Subject: [PATCH 3/6] use standard colors --- src/css/navbar.css | 30 ++++++++++++++++-------------- 1 file changed, 16 insertions(+), 14 deletions(-) diff --git a/src/css/navbar.css b/src/css/navbar.css index 3d5a0cce8..fe3bce3b2 100644 --- a/src/css/navbar.css +++ b/src/css/navbar.css @@ -37,22 +37,11 @@ color: var(--ifm-link-color); } -.dropdown__link--active { - background-color: transparent; - color: var(--ifm-text-color); -} -.dropdown__link--active:hover { - background-color: var(--aiven-nav-active-bg); -} - -.dropdown__link { - color: var(--ifm-text-color); -} .navbar__title { display: none; } -/* Dropdown container */ +/* Dropdown */ .navbar__item .dropdown__menu { border: 1px solid var(--ifm-color-emphasis-200); border-radius: 8px; @@ -60,13 +49,26 @@ min-width: 200px; } -/* Dropdown links */ +.dropdown__link--active { + background-color: transparent; + color: var(--ifm-text-color); +} +.dropdown__link--active:hover { + background-color: var(--aiven-nav-active-bg); +} + .dropdown__link { padding: 12px 16px; font-weight: 500; + color: var(--ifm-text-color); } .dropdown__link:hover { - background-color: var(--ifm-color-primary-lightest); + background-color: var(--aiven-nav-active-bg); + color: var(--ifm-link-color); +} + +[data-theme='dark'] .dropdown__link:hover { + background-color: var(--aiven-nav-active-bg); color: var(--ifm-color-primary); } From b3238c03f08532cc5eb97e9a279ee7b81dc546a8 Mon Sep 17 00:00:00 2001 From: Stacey Salamon Date: Wed, 18 Mar 2026 10:47:18 +0100 Subject: [PATCH 4/6] make sidebar categories larger --- src/css/custom.css | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/css/custom.css b/src/css/custom.css index 2c318fb8c..664d2ba8d 100644 --- a/src/css/custom.css +++ b/src/css/custom.css @@ -268,7 +268,7 @@ ul + div { /* Sidebar section titles */ .expandedSection > div > a { - font-weight: bold; + font-weight: 900; padding-top: 1em; padding-bottom: 0.5em; } From be83691c26214bbdd2e166eff7ab911dc3e73732 Mon Sep 17 00:00:00 2001 From: Stacey Salamon Date: Fri, 20 Mar 2026 10:39:03 +0100 Subject: [PATCH 5/6] remove dropdowns --- docusaurus.config.ts | 139 ++----------------------------------------- 1 file changed, 6 insertions(+), 133 deletions(-) diff --git a/docusaurus.config.ts b/docusaurus.config.ts index b47def64a..243f0e0b9 100644 --- a/docusaurus.config.ts +++ b/docusaurus.config.ts @@ -177,149 +177,22 @@ const config: Config = { }, items: [ { - type: 'dropdown', + type: 'docSidebar', position: 'left', label: 'Platform', - to: '/docs/get-started', - items: [ - { - type: 'doc', - docId: 'get-started', - label: 'Get started', - }, - { - type: 'doc', - docId: 'platform/concepts/orgs-units-projects', - label: 'Organizations, units, and projects', - }, - { - type: 'doc', - docId: 'platform/concepts/billing-and-payment', - label: 'Billing and payment', - }, - { - type: 'doc', - docId: 'platform/concepts/user-access-management', - label: 'User and access management', - }, - { - type: 'doc', - docId: 'platform/howto/list-authentication', - label: 'Authentication', - }, - { - type: 'doc', - docId: 'platform/howto/list-identity-providers', - label: 'Identity providers and domains', - }, - { - type: 'doc', - docId: 'platform/concepts/cloud-security', - label: 'Networking and security', - }, - ], + sidebarId: 'main', }, { - type: 'dropdown', + type: 'docSidebar', position: 'left', label: 'Services', - to: '/docs/products/services', - items: [ - { - type: 'doc', - docId: 'products/flink', - label: 'Apache Flink®', - }, - { - type: 'doc', - docId: 'products/kafka', - - label: 'Apache Kafka®', - }, - { - type: 'doc', - docId: 'products/clickhouse', - label: 'ClickHouse®', - }, - { - type: 'doc', - docId: 'products/dragonfly', - label: 'Dragonfly', - }, - { - type: 'doc', - docId: 'products/grafana', - label: 'Grafana®', - }, - { - type: 'doc', - docId: 'products/metrics', - label: 'Metrics', - }, - { - type: 'doc', - docId: 'products/mysql', - label: 'MySQL®', - }, - { - type: 'doc', - docId: 'products/opensearch', - label: 'OpenSearch®', - }, - { - type: 'doc', - docId: 'products/postgresql', - label: 'PostgreSQL®', - }, - { - type: 'doc', - docId: 'products/valkey', - label: 'Valkey™', - }, - { - type: 'doc', - docId: 'platform/howto/list-service', - label: 'Service management', - }, - { - type: 'doc', - docId: 'platform/concepts/service-integration', - label: 'Service integrations', - }, - ], + sidebarId: 'services', }, { - type: 'dropdown', + type: 'docSidebar', position: 'left', label: 'Tools', - to: '/docs/tools', - items: [ - { - type: 'doc', - docId: 'tools/api', - label: 'API', - }, - { - type: 'doc', - docId: 'tools/terraform', - label: 'Terraform Provider', - }, - { - type: 'doc', - docId: 'tools/kubernetes', - label: 'Kubernetes Operator', - }, - { - type: 'doc', - docId: 'tools/cli', - label: 'CLI', - }, - { - type: 'doc', - docId: 'tools/query-optimizer', - label: 'SQL query optimizer', - }, - ], + sidebarId: 'tools', }, { label: 'Aiven Console', From 5f41edc2ad38d34b53fdbf2a7d26e4dac007d6d1 Mon Sep 17 00:00:00 2001 From: Stacey Salamon Date: Fri, 20 Mar 2026 10:39:54 +0100 Subject: [PATCH 6/6] align service integrations sidebar title with others --- docs/platform/concepts/service-integration.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/platform/concepts/service-integration.md b/docs/platform/concepts/service-integration.md index 17adb9d07..eee0988aa 100644 --- a/docs/platform/concepts/service-integration.md +++ b/docs/platform/concepts/service-integration.md @@ -1,5 +1,6 @@ --- -title: Service integrations +title: Service integrations overview +sidebar_label: Overview --- Service integrations provide additional functionality and features by connecting different Aiven services together.