docs: document chrome_policy on on-demand browsers by aylee855 · Pull Request #377 · kernel/docs

aylee855 · 2026-05-22T22:10:27Z

Summary

Add a new /browsers/chrome-policy page that covers chrome_policy for both on-demand browsers.create() and reserved pools, with a quick reference of common policy keys.
Update /browsers/create-a-browser to show a chrome_policy (and start_url) example.
Slim down /browsers/pools/policy-json to focus on the pool-only update flow (discard_all_idle) and link out to the general reference for shared content.
Register browsers/chrome-policy in the Intermediate sidebar group in docs.json.

Test plan

Preview the new browsers/chrome-policy page and confirm code samples render correctly in both Typescript and Python tabs
Verify the sidebar shows the new page under "Working with your browser" → "Intermediate"
Click through internal links from create-a-browser, pools/policy-json, and chrome-policy to confirm they resolve

Note

Low Risk
Low risk documentation and styling-only changes; no runtime or API behavior is modified. Main risk is broken/incorrect links or misleading policy examples in the docs.

Overview
Adds a new browsers/chrome-policy guide documenting the chrome_policy field for both on-demand browsers.create() sessions and reserved browser pools, including TS/Python examples and a small table of common policy keys.

Updates browsers/create-a-browser to show start_url + chrome_policy usage, and trims browsers/pools/policy-json to focus on the pool update flow (notably discard_all_idle) while linking to the new shared reference. Registers the new page in docs.json navigation and tweaks style.css so inline code inside links doesn’t add padding/background (fixing underline width).

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

Add a new general /browsers/chrome-policy page covering chrome_policy for both on-demand sessions and reserved pools. Update create-a-browser to show the new options, and trim the pool-specific page to focus on pool-only behavior (discard_all_idle) while linking to the general reference. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

mintlify · 2026-05-22T22:17:32Z

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

Project	Status	Preview	Updated (UTC)
Kernel	🟢 Ready	View Preview	May 22, 2026, 10:18 PM

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

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

firetiger-agent · 2026-05-22T22:26:10Z

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: This PR only modifies documentation files and does not change any kernel API endpoints or Temporal workflows.

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

cursor

Stale comment

Risk assessment: Very Low.

I assessed the actual diff: it adds browsers/chrome-policy.mdx, updates related browser docs, and adds one navigation entry in docs.json. This is documentation/sidebar content only, with no production codepaths, infrastructure, auth, billing, permissions, or shared runtime behavior changed. I also found no CODEOWNERS file indicating a Codeowners approval requirement.

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 · 2026-05-22T22:30:32Z

+| `RestoreOnStartupURLs` | `string[]` | URLs to open when the browser starts. Requires `RestoreOnStartup` set to `4` |
+| `BookmarkBarEnabled` | `boolean` | Shows the bookmark bar |
+| `ManagedBookmarks` | `array` | Pre-configured bookmarks. Supports folders via nested `children` arrays |
+| `DownloadBubbleEnabled` | `boolean` | Controls the download bubble UI. Set to `false` to fall back to the classic download shelf |


Deprecated Chrome policy documented with incorrect behavior

Medium Severity

DownloadBubbleEnabled is a deprecated Chrome policy (removed after Chrome 118). Its table description claims setting it to false falls back to "the classic download shelf," but this Chromium UI element no longer exists in modern Chrome. This references version-specific Chromium implementation details as product documentation and will mislead users since the policy has no effect. It's also used as a prominent example in code samples across both new pages, which compounds the issue.

Additional Locations (2)

browsers/chrome-policy.mdx#L29-L30

browsers/create-a-browser.mdx#L47-L48

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

Absolute URLs were rendering with extra inline spacing inside the underlined link span. Relative paths render cleanly like other api-reference links in the docs.

cursor

Stale comment

Risk assessment: Very Low.

I assessed the current diff at the latest head: it adds browsers/chrome-policy.mdx, updates related browser documentation, trims duplicated pool-specific documentation, and adds one sidebar entry in docs.json. This is documentation/navigation content only, with no production codepaths, infrastructure, auth, billing, permissions, or shared runtime behavior changed.

I found no CODEOWNERS file in the repository. The PR is already approved, so I’m not submitting another approval.

_{Sent by Cursor Automation: Assign PR reviewers}

cursor

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

There are 2 total unresolved issues (including 1 from previous review).

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

^{Reviewed by Cursor Bugbot for commit 1441b9a. Configure here.}

cursor · 2026-05-22T22:38:09Z

+`chrome_policy` is supported on:
+
+- [`browsers.create()`](/api-reference/browsers/create-a-browser#body-chrome-policy) — on-demand browser sessions
+- [`browserPools.create()`](/api-reference/browser-pools/create-a-browser-pool#body-chrome-policy) and [`browserPools.update()`](/api-reference/browser-pools/update-a-browser-pool#body-chrome-policy) — reserved browser pools


Relative /api-reference/ links will break CI checks

High Severity

All /api-reference/... links in the new browsers/chrome-policy.mdx page (lines 10–11) and the updated browsers/pools/policy-json.mdx (line 6) use relative paths. API reference pages are auto-generated from a remote OpenAPI spec and don't exist locally, so relative links will fail the mint broken-links CI check. These need to be absolute URLs (e.g. https://kernel.sh/docs/api-reference/...). Notably, policy-json.mdx previously had the correct absolute URL and this PR regressed it to a relative one.

Additional Locations (1)

browsers/pools/policy-json.mdx#L5-L6

^{Triggered by learned rule: Use absolute URLs for /api-reference/ links}

^{Reviewed by Cursor Bugbot for commit 1441b9a. Configure here.}

The underline on <a> extended past the visible text because the nested <code> element had its own horizontal padding. Zero the padding and background on code inside links so the underline matches the text width.

cursor

Risk assessment: Very Low.

I assessed the latest diff at the current head. The PR adds browsers/chrome-policy.mdx, updates related browser docs, moves duplicated policy reference content into the new page, adds one docs.json navigation entry, and makes a small docs-site CSS adjustment for inline code inside links.

This remains docs/navigation/styling-only for the documentation site. It does not modify production codepaths, infrastructure, auth, billing, permissions, database/schema, generated API specs, or shared runtime behavior. I found no CODEOWNERS file indicating a Codeowners approval requirement.

The PR is already approved, so I’m not submitting another approval. The latest update does not increase the risk level.

_{Sent by Cursor Automation: Assign PR reviewers}

aylee855 requested a review from ehfeng May 22, 2026 22:13

mintlify Bot deployed to staging May 22, 2026 22:18 View deployment

docs: trim pool example in chrome-policy.mdx to match on-demand length

a5e62b0

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

mintlify Bot deployed to staging May 22, 2026 22:21 View deployment

cursor Bot approved these changes May 22, 2026 •

edited

Loading

View reviewed changes

ehfeng marked this pull request as ready for review May 22, 2026 22:25

cursor Bot reviewed May 22, 2026

View reviewed changes

docs: use relative paths for chrome_policy api-reference links

1441b9a

Absolute URLs were rendering with extra inline spacing inside the underlined link span. Relative paths render cleanly like other api-reference links in the docs.

mintlify Bot deployed to staging May 22, 2026 22:36 View deployment

cursor Bot reviewed May 22, 2026

View reviewed changes

docs: strip inline-code padding inside links

4f05af0

The underline on <a> extended past the visible text because the nested <code> element had its own horizontal padding. Zero the padding and background on code inside links so the underline matches the text width.

mintlify Bot deployed to staging May 24, 2026 04:42 View deployment

cursor Bot reviewed May 24, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

docs: document chrome_policy on on-demand browsers#377

docs: document chrome_policy on on-demand browsers#377
aylee855 wants to merge 4 commits into
mainfrom
hypeship/docs-chrome-policy-on-demand

aylee855 commented May 22, 2026 •

edited by cursor Bot

Loading

Uh oh!

mintlify Bot commented May 22, 2026 •

edited

Loading

Uh oh!

firetiger-agent Bot commented May 22, 2026

Uh oh!

cursor Bot left a comment •

edited

Loading

Uh oh!

cursor Bot May 22, 2026

Uh oh!

cursor Bot left a comment •

edited

Loading

Uh oh!

cursor Bot left a comment

Uh oh!

cursor Bot May 22, 2026

Uh oh!

cursor Bot left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

aylee855 commented May 22, 2026 • edited by cursor Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Test plan

Uh oh!

mintlify Bot commented May 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

firetiger-agent Bot commented May 22, 2026

Uh oh!

cursor Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cursor Bot May 22, 2026

Choose a reason for hiding this comment

Deprecated Chrome policy documented with incorrect behavior

Uh oh!

cursor Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

cursor Bot May 22, 2026

Choose a reason for hiding this comment

Relative /api-reference/ links will break CI checks

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

aylee855 commented May 22, 2026 •

edited by cursor Bot

Loading

mintlify Bot commented May 22, 2026 •

edited

Loading

cursor Bot left a comment •

edited

Loading

cursor Bot left a comment •

edited

Loading

Relative `/api-reference/` links will break CI checks