From e36ca3257ea948049c79a065f6ac5c0ae3445424 Mon Sep 17 00:00:00 2001 From: openhands Date: Sat, 11 Apr 2026 04:31:11 +0000 Subject: [PATCH 1/5] Add dedicated Cloud docs tab Co-authored-by: openhands --- docs.json | 55 ++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 54 insertions(+), 1 deletion(-) diff --git a/docs.json b/docs.json index d4261a9b6..9ff6e84bd 100644 --- a/docs.json +++ b/docs.json @@ -402,6 +402,59 @@ } ] }, + { + "tab": "Cloud", + "pages": [ + { + "group": "Product Guides", + "pages": [ + { + "group": "Settings", + "pages": [ + "openhands/usage/settings/integrations-settings", + "openhands/usage/settings/api-keys-settings" + ] + }, + { + "group": "OpenHands Cloud", + "pages": [ + "openhands/usage/cloud/openhands-cloud", + "openhands/usage/cloud/cloud-ui" + ] + }, + { + "group": "Automations (BETA)", + "icon": "clock", + "pages": [ + "openhands/usage/automations/overview", + "openhands/usage/automations/creating-automations", + "openhands/usage/automations/managing-automations", + "openhands/usage/automations/examples" + ] + } + ] + }, + { + "group": "Integrations", + "pages": [ + "openhands/usage/settings/integrations-settings", + "openhands/usage/cloud/github-installation", + "openhands/usage/cloud/gitlab-installation", + "openhands/usage/cloud/bitbucket-installation", + "openhands/usage/cloud/slack-installation", + "openhands/usage/cloud/project-management/jira-integration", + { + "group": "Cloud API", + "pages": [ + "openhands/usage/cloud/cloud-api", + "openhands/usage/cloud/plugin-launcher", + "openhands/usage/api/v1" + ] + } + ] + } + ] + }, { "tab": "Enterprise", "pages": [ @@ -700,4 +753,4 @@ "destination": "/openhands/usage/v0/runtimes/V0_daytona" } ] -} \ No newline at end of file +} From df1ba6d9e1fd8ce7b22a859e5ddfdb7237817bee Mon Sep 17 00:00:00 2001 From: openhands Date: Sat, 11 Apr 2026 04:43:07 +0000 Subject: [PATCH 2/5] Simplify Cloud tab sidebar groups Co-authored-by: openhands --- docs.json | 45 ++++++++++++++++++++------------------------- 1 file changed, 20 insertions(+), 25 deletions(-) diff --git a/docs.json b/docs.json index 9ff6e84bd..43cdd5dfc 100644 --- a/docs.json +++ b/docs.json @@ -406,32 +406,17 @@ "tab": "Cloud", "pages": [ { - "group": "Product Guides", + "group": "Settings", "pages": [ - { - "group": "Settings", - "pages": [ - "openhands/usage/settings/integrations-settings", - "openhands/usage/settings/api-keys-settings" - ] - }, - { - "group": "OpenHands Cloud", - "pages": [ - "openhands/usage/cloud/openhands-cloud", - "openhands/usage/cloud/cloud-ui" - ] - }, - { - "group": "Automations (BETA)", - "icon": "clock", - "pages": [ - "openhands/usage/automations/overview", - "openhands/usage/automations/creating-automations", - "openhands/usage/automations/managing-automations", - "openhands/usage/automations/examples" - ] - } + "openhands/usage/settings/integrations-settings", + "openhands/usage/settings/api-keys-settings" + ] + }, + { + "group": "OpenHands Cloud", + "pages": [ + "openhands/usage/cloud/openhands-cloud", + "openhands/usage/cloud/cloud-ui" ] }, { @@ -452,6 +437,16 @@ ] } ] + }, + { + "group": "Automations (BETA)", + "icon": "clock", + "pages": [ + "openhands/usage/automations/overview", + "openhands/usage/automations/creating-automations", + "openhands/usage/automations/managing-automations", + "openhands/usage/automations/examples" + ] } ] }, From ffd98e05528eade5e1779fe78cd1dd499888c3b2 Mon Sep 17 00:00:00 2001 From: openhands Date: Sat, 11 Apr 2026 04:55:02 +0000 Subject: [PATCH 3/5] Make Cloud tab own its navigation Co-authored-by: openhands --- AGENTS.md | 4 ++++ docs.json | 43 ------------------------------------------- 2 files changed, 4 insertions(+), 43 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 50bc8cd6d..a8e99f357 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -153,6 +153,10 @@ Workflow: `.github/workflows/sync-agent-sdk-openapi.yml` - When linking internally, prefer **absolute** doc paths (e.g. `/overview/quickstart`). - Cloud integration docs live under `openhands/usage/cloud/`, and pages surfaced in **Documentation → Integrations → Cloud API** must also be added to the `Cloud API` group in `docs.json`. +### Mintlify tab ownership + +When the same page path appears under multiple top-level tabs in `docs.json`, Mintlify resolves the page to one tab/sidebar (effectively the first matching tab). If you want a page to show a distinct left navigation for a new tab, that page should live **exclusively** under that tab rather than being duplicated across tabs. + ### SDK guide file naming SDK guide files under `sdk/guides/` use a **category prefix** to group related pages: diff --git a/docs.json b/docs.json index 43cdd5dfc..6be880cb4 100644 --- a/docs.json +++ b/docs.json @@ -67,37 +67,9 @@ "pages": [ "openhands/usage/settings/application-settings", "openhands/usage/settings/llm-settings", - "openhands/usage/settings/integrations-settings", "openhands/usage/settings/secrets-settings", - "openhands/usage/settings/api-keys-settings", "openhands/usage/settings/mcp-settings" ] - }, - { - "group": "OpenHands Cloud", - "pages": [ - "openhands/usage/cloud/openhands-cloud", - "openhands/usage/cloud/cloud-ui" - ] - } - ] - }, - { - "group": "Integrations", - "pages": [ - "openhands/usage/settings/integrations-settings", - "openhands/usage/cloud/github-installation", - "openhands/usage/cloud/gitlab-installation", - "openhands/usage/cloud/bitbucket-installation", - "openhands/usage/cloud/slack-installation", - "openhands/usage/cloud/project-management/jira-integration", - { - "group": "Cloud API", - "pages": [ - "openhands/usage/cloud/cloud-api", - "openhands/usage/cloud/plugin-launcher", - "openhands/usage/api/v1" - ] } ] }, @@ -462,21 +434,6 @@ "enterprise/k8s-install/index", "enterprise/k8s-install/resource-limits" ] - }, - { - "group": "Product Guides", - "pages": [ - { - "group": "Automations (BETA)", - "icon": "clock", - "pages": [ - "openhands/usage/automations/overview", - "openhands/usage/automations/creating-automations", - "openhands/usage/automations/managing-automations", - "openhands/usage/automations/examples" - ] - } - ] } ] } From e52cd6191a84e66b247e323044bf55e91d04c342 Mon Sep 17 00:00:00 2001 From: openhands Date: Sat, 11 Apr 2026 05:12:13 +0000 Subject: [PATCH 4/5] Reorder Cloud tab sections Co-authored-by: openhands --- docs.json | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs.json b/docs.json index 6be880cb4..625a7ef68 100644 --- a/docs.json +++ b/docs.json @@ -378,17 +378,17 @@ "tab": "Cloud", "pages": [ { - "group": "Settings", + "group": "OpenHands Cloud", "pages": [ - "openhands/usage/settings/integrations-settings", - "openhands/usage/settings/api-keys-settings" + "openhands/usage/cloud/openhands-cloud", + "openhands/usage/cloud/cloud-ui" ] }, { - "group": "OpenHands Cloud", + "group": "Settings", "pages": [ - "openhands/usage/cloud/openhands-cloud", - "openhands/usage/cloud/cloud-ui" + "openhands/usage/settings/integrations-settings", + "openhands/usage/settings/api-keys-settings" ] }, { From ced6b670acd54d99049029b59299aeedcbcbf471 Mon Sep 17 00:00:00 2001 From: openhands Date: Sat, 11 Apr 2026 05:35:23 +0000 Subject: [PATCH 5/5] Rename footer Cloud link Co-authored-by: openhands --- docs.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs.json b/docs.json index 625a7ef68..0dc442dda 100644 --- a/docs.json +++ b/docs.json @@ -468,7 +468,7 @@ "href": "https://openhands.dev/blog" }, { - "label": "OpenHands Cloud", + "label": "Cloud", "href": "https://app.all-hands.dev" }, {