Add Create, Control, Observe introduction guides

[ehfeng]

Summary

Adds three high-level concept guides under the Introduction group to orient new users around Kernel's core surface area:

• Create (introduction/create.mdx) — spinning up a browser, picking the right shape (headless, stealth, GPU, profiles), and lifecycle.
• Control (introduction/control.mdx) — the two ways to drive a browser: computer controls (model-native, vision loops) vs Playwright execution (DOM, full-page screenshots). Includes a when-to-use-which table and the recommended pattern of using both together.
• Observe (introduction/observe.mdx) — live view, replays, screenshots, and invocation logs, framed by what each is good for.

docs.json is updated to rename the first nav group from home to Introduction and add the three new pages alongside index.

Preview

Once Mintlify builds: https://tbd-6fc993ce-hypeship-intro-create-control-observe.mintlify.app/introduction/create (and /control, /observe).

Test plan

• mintlify dev renders the three new pages
• All cross-page links resolve (anchors verified against current H2/H3s)
• Sidebar shows "Introduction" group with index + three new pages in order

---

Note

Low Risk
Low risk docs-only change that reorganizes navigation and adds redirects; main risk is broken internal links/anchors due to moved content.

Overview
Adds a new Introduction docs entrypoint with three concept guides: introduction/create, introduction/control, and introduction/observe, and updates the homepage to route users through these starting points.

Replaces the legacy browsers/create-a-browser page by removing it, adding a redirect to /introduction/create, and updating cross-doc references (auth FAQ, integrations, pools scaling, changelog, and the code example guide) to point at the new Create/Control pages.

Clarifies browser standby and timeout/termination semantics by defining what counts as “activity” (CDP/WebDriver, Live View, computer controls) and tying timeout start explicitly to entering standby.

^{Reviewed by Cursor Bugbot for commit 610f57a. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

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

Project	Status	Preview	Updated (UTC)
Kernel	🟢 Ready	View Preview	May 20, 2026, 7:36 PM

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

[cursor]

Stale comment

Risk assessment: Very Low

The current diff is limited to documentation and navigation: new introduction/create, introduction/control, and introduction/observe MDX pages, a small docs.json sidebar update, and wording clarifications in browsers/standby.mdx and browsers/termination.mdx. I found no production codepaths, infrastructure, auth/security, data, prompt/instruction files, or shared runtime behavior changes.

No CODEOWNERS file was present in the repo. The PR is already approved at the current head commit, so I’m not submitting another approval.

  

_{Sent by Cursor Automation: Assign PR reviewers}

[cursor]

Stale comment

Risk assessment: Very Low

The current diff is limited to documentation and Mintlify navigation: three new introduction/* MDX guides, a redirect/sidebar update in docs.json, link retargeting from the removed browsers/create-a-browser.mdx page, and small wording clarifications for standby/termination behavior. The .docs/code-example-guide.md change only updates a reference to the moved guide path.

I found no production codepaths, shared runtime behavior, infrastructure, auth/security, data/schema changes, or non-trivial prompt/instruction changes. No CODEOWNERS file was present. GitHub already reports this PR as approved, so I’m not submitting another approval.

  

_{Sent by Cursor Automation: Assign PR reviewers}

[firetiger-agent]

Firetiger deploy monitoring skipped

This PR didn't match the auto-monitor filter configured on your GitHub connection:

Any PR that changes the kernel API. Monitor changes to API endpoints (packages/api/cmd/api/) and Temporal workflows (packages/api/lib/temporal) in the kernel repo

Reason: PR only adds documentation guides and updates docs.json; no changes to API endpoints or Temporal workflows.

To monitor this PR anyway, reply with @firetiger monitor this.

[cursor]

Stale comment

Risk assessment: Very Low

The current diff is limited to Mintlify documentation changes: new introduction/create, introduction/control, and introduction/observe guides, removal of the old browsers/create-a-browser page with a redirect to introduction/create, navigation updates in docs.json, link retargeting, and small wording clarifications for standby/termination behavior.

I found no production codepaths, infrastructure, auth/security, data/schema changes, or shared runtime behavior changes. The only .docs change updates a reference path in the code example guide, which is a trivial documentation-maintenance edit. No CODEOWNERS file was present.

GitHub already reports this PR as approved, so I’m leaving this assessment as a comment and not submitting another approval.

  

_{Sent by Cursor Automation: Assign PR reviewers}

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 4e62b81. Configure here.}

[cursor]

Stale comment

Risk assessment: Very Low

I re-evaluated the current head diff (c5fd931). The changes remain limited to Mintlify documentation and navigation: new introduction/create, introduction/control, and introduction/observe guides, removal of the old browsers/create-a-browser page with a redirect, link retargeting, and small wording clarifications around standby/termination and “computer use.”

I found no production codepaths, infrastructure, auth/security, data/schema changes, or shared runtime behavior changes. The .docs/code-example-guide.md edit is only a reference-path update. I also found no CODEOWNERS file in the repo.

GitHub already reports this PR as approved, and this update does not increase the risk, so I’m leaving this as a comment and not submitting another approval.

  

_{Sent by Cursor Automation: Assign PR reviewers}

[dprevoznik]

Left some suggestions and a few open-ended questions

[cursor]

Stale comment

Risk assessment: Very Low

I re-evaluated the current diff at head 296de55. The changes are limited to Mintlify documentation and navigation: new introduction/create, introduction/control, and introduction/observe guides, removal of browsers/create-a-browser with a redirect to introduction/create, sidebar/card/link retargeting, and small wording updates around standby and termination behavior.

I found no production codepaths, infrastructure, auth/security, data/schema changes, or shared runtime behavior changes. The .docs/code-example-guide.md edit is a trivial reference-path update, not a substantive prompt/instruction change. I also found no CODEOWNERS file in the repo.

GitHub already reports this PR as approved, and the new diff does not increase risk, so I’m leaving this as a comment and not submitting another approval.

  

_{Sent by Cursor Automation: Assign PR reviewers}

[cursor]

Stale comment

Risk assessment: Very Low

I re-evaluated the current diff at head 81d0027. The changes remain limited to Mintlify documentation and navigation: three new introduction/* guides, removal of the old browsers/create-a-browser page with a redirect, sidebar/card/link retargeting, and small wording updates around standby, termination, and browser control options.

I found no production codepaths, infrastructure, auth/security, data/schema changes, or shared runtime behavior changes. The .docs/code-example-guide.md edit is only a reference-path update, not a substantive prompt/instruction change. I also found no CODEOWNERS file in the repo.

GitHub already reports this PR as approved, and the latest update does not increase risk, so I’m leaving this as a comment and not submitting another approval.

  

_{Sent by Cursor Automation: Assign PR reviewers}

[cursor]

Stale comment

Risk assessment: Very Low

I evaluated the current diff at head 9b61df4. The changes are limited to Mintlify documentation and navigation: new introduction/create, introduction/control, and introduction/observe guides, a redirect from the removed browsers/create-a-browser page, sidebar/card/link retargeting, and small wording updates in existing docs.

I found no production codepaths, infrastructure, auth/security, data/schema, or shared runtime behavior changes. The .docs/code-example-guide.md edit only updates a reference path from the removed page to the new intro page. I also found no CODEOWNERS file in the repo.

GitHub currently reports this PR as already approved, and the latest update does not increase risk, so I’m leaving this assessment as a comment and not submitting another approval or dismissing the existing approval.

  

_{Sent by Cursor Automation: Assign PR reviewers}

[cursor]

Stale comment

Risk assessment: Very Low

I evaluated the current diff at head cf48008. The PR changes are limited to Mintlify documentation and navigation: three new introduction/* guides, removal of browsers/create-a-browser.mdx with a redirect to introduction/create, sidebar/card/link retargeting, and small wording updates in existing docs.

The latest synchronize update only adjusts documentation copy in index.mdx and introduction/control.mdx; it does not increase the risk from the previous assessment. I found no production codepaths, infrastructure, auth/security, data/schema, or shared runtime behavior changes. The .docs/code-example-guide.md edit is just a reference-path update. I also found no CODEOWNERS file in the repo.

GitHub already reports this PR as approved, so I’m leaving this assessment as a comment and not submitting another approval or dismissing the existing approval.

  

_{Sent by Cursor Automation: Assign PR reviewers}

[cursor]

Risk assessment: Very Low

I evaluated the current diff at head cf6c7bbe. The PR is limited to Mintlify documentation and navigation: new introduction/create, introduction/control, and introduction/observe guides, removal of browsers/create-a-browser.mdx with a redirect to introduction/create, sidebar/card/link retargeting, and small wording updates in existing docs.

The latest synchronize update only changes documentation copy in introduction/control.mdx and introduction/create.mdx by clarifying Playwright/computer-control guidance, adding an SDK install note, and deep-linking the termination guide. I found no production codepaths, infrastructure, auth/security, data/schema, or shared runtime behavior changes. The .docs/code-example-guide.md edit is only a reference-path update, and I found no CODEOWNERS file in the repo.

GitHub already reports this PR as approved, and this update does not increase risk, so I’m leaving this assessment as a comment and not submitting another approval or dismissing the existing approval.

  

_{Sent by Cursor Automation: Assign PR reviewers}

[cursor]

Risk assessment: Very Low

I evaluated the current diff at head 610f57a. The PR changes are limited to Mintlify documentation and navigation: new introduction/create, introduction/control, and introduction/observe guides, removal of browsers/create-a-browser.mdx with a redirect to introduction/create, sidebar/home-card/link retargeting, and small wording updates in existing docs.

I found no production codepaths, infrastructure, auth/security, data/schema, or shared runtime behavior changes. The .docs/code-example-guide.md change only updates a reference path to the moved guide, not substantive instruction content. I also found no CODEOWNERS file in the repo.

GitHub already reports this PR as approved, and the latest synchronize update does not increase risk, so I’m leaving this assessment as a comment and not submitting another approval or dismissing the existing approval.

  

_{Sent by Cursor Automation: Assign PR reviewers}