Skip to content

docs: add Onboarding Agent Canvas section#533

Draft
jpelletier1 wants to merge 9 commits into
mainfrom
docs/onboarding-agent-canvas
Draft

docs: add Onboarding Agent Canvas section#533
jpelletier1 wants to merge 9 commits into
mainfrom
docs/onboarding-agent-canvas

Conversation

@jpelletier1
Copy link
Copy Markdown
Contributor

Summary

This PR reorganizes the Documentation navigation to introduce Agent Canvas as the primary onboarding path, and brings in the full Agent Canvas doc set from the docs/agent-canvas-docs branch.

Changes

Navigation (docs.json)

  • Renamed Onboarding OpenHandsOnboarding Agent Canvas
  • Added all 9 Agent Canvas pages under Onboarding Agent Canvas:
    • Overview, Setup, Backends, LLM Profiles, Customize & Settings, Automations, Self-Hosting, Development, Troubleshooting
  • Moved Hooks out of the onboarding group and into Product Guides (after Key Features)

Quick Start (overview/quickstart.mdx)

  • Replaced the 3-card layout (OpenHands Cloud, Terminal/CLI, Local GUI) with a single card: "Install OpenHands Agent Canvas" → /openhands/usage/agent-canvas/setup
  • OpenHands Cloud is now a bullet item inside that card

New pages (openhands/usage/agent-canvas/)

9 MDX files pulled from docs/agent-canvas-docs:
overview, setup, backends, llm-profiles, customize-and-settings, automations, self-hosting, development, troubleshooting


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

@jpelletier1 can click here to continue refining the PR

- Rename 'Onboarding OpenHands' group to 'Onboarding Agent Canvas'
- Add agent-canvas docs (overview, setup, backends, llm-profiles,
  customize-and-settings, automations, self-hosting, development,
  troubleshooting) under Onboarding Agent Canvas
- Move Hooks to Product Guides section
- Update Quick Start to single 'Install OpenHands Agent Canvas' card
  with OpenHands Cloud as a bullet item

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

mintlify Bot commented May 28, 2026

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

Project Status Preview Updated (UTC)
all-hands-ai 🟢 Ready View Preview May 28, 2026, 1:01 PM

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

- Remove bullet points from Agent Canvas card in Quick Start
- Add OpenHands Cloud as a single bullet below the card
- Move Repository Customization to Product Guides, after Automations

Co-authored-by: openhands <openhands@all-hands.dev>
@jpelletier1
Copy link
Copy Markdown
Contributor Author

jpelletier1 commented May 28, 2026

Future updates:

  • "First time setup" section: walk through of onboarding wizard, selecting agent, selecting model, configuring a pre-built automation
  • For each pre-built automation, we should have supporting docs:
    • Scheduled, polling-based, or event based?
    • What MCP integration are required
    • How to configure that integration (slack, jira, github, etc.) - this should cover the steps within that tool for getting a token

@jpelletier1 jpelletier1 linked an issue May 28, 2026 that may be closed by this pull request
- Rename 'Setup' page title to 'Install'
- Add 'Setup a Pre-built Automation' group with placeholder sub-pages:
  GitHub PR Review Assistant, GitHub Repository Monitor, Slack Channel Monitor
- Remove LLM Profiles and Model Configuration from nav
- Add links to Skills and MCP Servers under Customize header in customize-and-settings
- Remove stale llm-profiles link from Related Guides

Co-authored-by: openhands <openhands@all-hands.dev>
- Convert flat backends entry to a nav group
- Add placeholder sub-pages: Local, VM, Docker, OpenHands Cloud

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

- Move automations.mdx content into prebuilt-automations.mdx
- Add intro section at top of prebuilt-automations linking to the
  three pre-built automation sub-pages (PR review, repo monitor, Slack)
- Delete automations.mdx
- Remove automations from Onboarding Agent Canvas nav

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

Before you start, make sure the machine has:

- Node.js 22.12 or later
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

perhaps links on how to install them (Node and npm)

Covers all four onboarding steps with screenshots:
- Step 1: Choose your agent (OpenHands, Claude Code, Codex, Gemini CLI via ACP)
- Step 2: Check your backend (local default, link to backends guide)
- Step 3: Set up your LLM (BYOK + OpenHands Cloud link)
- Step 4: Start from a proven workflow (GitHub PR Review Copilot + pre-built automations)

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.

Docs: New User Enablement Materials

4 participants