Skip to content

docs: consolidate sandbox docs under /sandboxes and add redirects - #445

Merged
sophiajwitt merged 2 commits into
mainfrom
sophia/sandbox-docs-agent-friendly
Aug 4, 2026
Merged

docs: consolidate sandbox docs under /sandboxes and add redirects#445
sophiajwitt merged 2 commits into
mainfrom
sophia/sandbox-docs-agent-friendly

Conversation

@sophiajwitt

@sophiajwittsophiajwitt commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

What

  1. Consolidates all sandbox docs under the /sandboxes prefix. The SDK subtree was the odd one out at /sandbox/sdk/* (singular); this moves it to /sandboxes/sdk/* so every sandbox page shares one prefix. Internal links and nav are updated to match.
  2. Adds redirects from every old /sandbox/* path to its /sandboxes/* equivalent, plus /sandboxes/quickstart and /sandbox/quickstart/sandboxes/getting-started.

Why

sandbox (singular) was the only singular top-level prefix in the docs — every other section is plural (applications, cloud-accounts, addons, integrations, preview-environments), and the nav group is literally "Sandboxes". The split prefix made URLs hard to guess: coding agents pointed at Porter sandboxes learn one prefix and 404 on the other (e.g. Claude reliably guesses /sandboxes/quickstart). Unifying on /sandboxes + redirecting the old paths closes those dead ends without breaking existing links.

🤖 Generated with Claude Code

Coding agents pointed at Porter sandboxes guess /sandboxes/quickstart
(and /sandbox/quickstart) and 404. Redirect both to the actual intro
page at /sandboxes/getting-started.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@mintlify

mintlifyBot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

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

ProjectStatusPreviewUpdated (UTC)
porter🟢 ReadyView PreviewAug 4, 2026, 8:09 PM

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

The sandbox guides lived under /sandboxes while the SDK subtree lived
under singular /sandbox/sdk. That split is the lone singular prefix in
the docs (every other section - applications, cloud-accounts, addons,
integrations, preview-environments - is plural) and makes URLs hard to
guess, especially for agents that learn one prefix and 404 on the other.
Move sandbox/sdk/* to sandboxes/sdk/*, update all internal links and
nav, and add redirects from every old /sandbox/* path to its /sandboxes/*
equivalent so existing links keep working.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@sophiajwittsophiajwitt changed the title docs: redirect /sandboxes/quickstart to /sandboxes/getting-starteddocs: consolidate sandbox docs under /sandboxes and add redirectsAug 4, 2026
@sophiajwitt
sophiajwitt merged commit a4d124d into mainAug 4, 2026
2 checks passed
@sophiajwitt
sophiajwitt deleted the sophia/sandbox-docs-agent-friendly branch August 4, 2026 20:14
Sign up for freeto 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.

1 participant

@sophiajwitt