Skip to content

Remove Deprecated Projects group from Home tab navigation - #989

Open
jpelletier1 wants to merge 6 commits into
mainfrom
remove-deprecated-projects-nav
Open

jpelletier1 wants to merge 6 commits into
mainfrom
remove-deprecated-projects-nav

Conversation

@jpelletier1

@jpelletier1 jpelletier1 commented Oct 21, 2026 •

Copy link
Copy Markdown
Contributor
  • I have read and reviewed the documentation changes to the best of my ability.
  • If the change is significant, I have run the documentation site locally and confirmed it renders as expected.

Summary of changes

Removes the "Deprecated Projects" group (Local GUI, CLI, and V0 runtimes: 36 pages) from the Home tab sidebar, and cleans up every page that linked to those pages or described the CLI and Local GUI. Agent Canvas is now the pointer for running OpenHands yourself. The deprecated .mdx files are intentionally left in place and remain reachable by direct URL; deleting them (with redirects) can be a follow-up.

Changes by file

  • docs.json: removes the "Deprecated Projects" group from the Home tab navigation.
  • sdk/index.mdx: the "engine behind" sentence now names Agent Canvas and OpenHands Cloud instead of the CLI.
  • overview/faqs.mdx: "Run on your own" step now points to Agent Canvas; removes the Troubleshooting step and the links to the hardened Docker, filesystem mount, security configuration, and custom sandbox pages.
  • overview/introduction.mdx: the Legacy accordion now covers only the Local GUI (CLI block removed).
  • overview/model-context-protocol.mdx: adds Agent Canvas to the MCP Support Matrix; removes the CLI and Local GUI rows, the "Platform-Specific Differences" section, and the "For CLI usage" bullet.
  • overview/plugins.mdx: replaces the CLI and Local GUI tabs under "Using Plugins" with an Agent Canvas tab; the install and test steps use ~/.agents/plugins instead of openhands --plugin.
  • overview/skills/adding.mdx: replaces the CLI and Local GUI storage tabs with an Agent Canvas tab; user-level skills now use ~/.agents/skills/.
  • overview/skills/org.mdx: removes the "User Skills When Running OpenHands on Your Own" section.
  • openhands/usage/settings/mcp-settings.mdx: removes the CLI bullets, the CLI OAuth tab, and the config.toml / V0 legacy-format references.
  • openhands/usage/settings/api-keys-settings.mdx: the key can be used "with Agent Canvas" instead of the CLI and self-hosted setup.
  • openhands/usage/settings/integrations-settings.mdx: removes the Local GUI link and note.
  • openhands/usage/llms/openhands-llms.mdx: replaces the CLI provider section with an Agent Canvas section (Settings > LLM, OpenHands provider).
  • openhands/usage/llms/local-llms.mdx: unlinks the local setup references; removes the Atomic Chat CLI integration sentence.
  • openhands/usage/llms/llms.mdx, custom-llm-configs.mdx, google-llms.mdx: remove links to the Configuration Options and Custom Sandbox Guide pages.
  • openhands/usage/troubleshooting/troubleshooting.mdx: removes the link to the deleted user skills section.
  • openhands/static/img/openhands-provider-cli.png: deleted; it was only used by the removed CLI provider section.

Validation: docs.json still parses as valid JSON, and a scan finds no remaining links to the 36 deprecated pages from pages outside the removed group. I have not run mint dev or mint broken-links locally.

This PR was drafted by an AI agent on behalf of the user.

@jpelletier1 can click here to continue refining the PR

Co-authored-by: openhands <openhands@all-hands.dev>
@mintlify

mintlify Bot commented Oct 21, 2026 •

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
all-hands-ai 🟢 Ready View Preview Oct 22, 2026, 12:21 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

Unlink or reword references to the pages in the removed Deprecated Projects
nav group, drop CLI-only sections, and point to Agent Canvas instead.

Co-authored-by: openhands <openhands@all-hands.dev>
- Add Agent Canvas to the MCP support matrix and drop Platform-Specific Differences
- Remove config.toml references from MCP settings
- Remove the self-hosted user skills section from org skills

Co-authored-by: openhands <openhands@all-hands.dev>
…anvas

Co-authored-by: openhands <openhands@all-hands.dev>
Co-authored-by: openhands <openhands@all-hands.dev>

@smolpaws smolpaws left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm an AI agent helping Engel Nyst with project work.

Reviewed 71a3c3b1cfc6a64cdf5d76f13835463342232b0e. I found one correctness regression: removing the Local GUI-only qualification leaves its token-setup walkthrough presented as general self-hosted guidance, although those fields are unavailable in local Agent Canvas. Please retain the qualification or replace/remove that walkthrough; details are inline.

The navigation cleanup itself looks sound. All 36 removed navigation targets still exist, the remaining navigation targets resolve, and a scan found no inbound links from other MDX pages to those 36 routes. Retaining the hidden pages for a later deletion/redirect pass matches this PR's stated scope.

Validation: mint broken-links and git diff --check passed locally. The broken-links workflow and pricing validator also passed on this head.

Source Verification

Claim Evidence
Hosted integrations settings are unavailable for local Canvas backends, so the removed qualification matters Canvas backend guard
Canvas exposes MCP Servers through Customize navigation Navigation entries
Agent Server reads project .openhands/hooks.json Hook configuration reader
The new user plugin discovery paths and automatic loading are implemented Discovery paths, conversation loading
~/.agents/skills/ is a supported user-skill location User-skill loader

Comment thread openhands/usage/settings/integrations-settings.mdx
…tegrations list

Co-authored-by: openhands <openhands@all-hands.dev>

This branch was successfully deployed

1 active deployment
staging — 5eededb5 Deployed Oct 22, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants