Skip to content

docs: update repository boundaries and Agent Canvas architecture - #688

Draft
DevinVinson wants to merge 4 commits into
mainfrom
docs/686-repository-boundaries
Draft

docs: update repository boundaries and Agent Canvas architecture#688
DevinVinson wants to merge 4 commits into
mainfrom
docs/686-repository-boundaries

Conversation

@DevinVinson

@DevinVinson DevinVinson commented Aug 4, 2026

Copy link
Copy Markdown
Member

Summary

  • update product and repository ownership boundaries after the repository migration
  • add a canonical Agent Canvas architecture page and clarify Agent Server, Automation Server, managed Cloud/Enterprise control-plane, and community Sandbox Server boundaries
  • add generic Remote Backend documentation, reorganize Agent Canvas navigation, and move Modal under self-hosted backend services
  • correct Docker/Helm UI paths and reassign the V1 API documentation to Sandbox Server
  • exclude obsolete monorepo architecture pages from generated LLM context

Review status

This is a first pass over the broad scope in #686. It still needs a full human review, preferably page by page, for product language, information architecture, technical accuracy, and the remaining decisions listed in the issue. Please keep this PR in draft until that review is complete.

The latest pass clarifies that Sandbox Server is community-driven and not a core or supported Agent Canvas backend. It also distinguishes a generic remote Agent Server from the managed Cloud and Enterprise platforms, whose control planes create the sandboxes that host Agent Server.

Validation

  • local Mintlify preview renders the revised architecture page and navigation
  • 31 affected tests pass
  • docs.json parses successfully
  • git diff --check passes
  • regenerated llms.txt and llms-full.txt omit the obsolete backend/runtime architecture pages

Known unrelated issue

The complete pricing test suite has two pre-existing errors because it fetches the removed OpenHands/OpenHands/main/openhands/utils/llm.py path. That separate pricing-source migration is not included here.

Closes #686

This draft pull request was created by an AI agent (OpenHands) on behalf of the user.

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

mintlify Bot commented Aug 4, 2026

Copy link
Copy Markdown

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

Project Status Preview Updated (UTC)
all-hands-ai 🟢 Ready View Preview Aug 4, 2026, 5:55 PM

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

Co-authored-by: openhands <openhands@all-hands.dev>
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.

Update docs for new repository boundaries and Agent Canvas architecture

1 participant