Skip to content

docs: retire the shared-workspace and Workflows pages#3128

Open
benjaminshafii wants to merge 1 commit into
devfrom
docs/retire-unsold-and-stale-pages
Open

docs: retire the shared-workspace and Workflows pages#3128
benjaminshafii wants to merge 1 commit into
devfrom
docs/retire-unsold-and-stale-pages

Conversation

@benjaminshafii

Copy link
Copy Markdown
Member

Why

Two published pages were pulling their weight in the wrong direction.

We don't sell shared workspaces right now. cloud/run-in-the-cloud/shared-workspace.mdx walked readers through deploying hosted cloud workers. The product already contradicts it — that dashboard screen is labelled Alpha and banners "New cloud workspaces are no longer available from this page." Documenting a flow we don't sell sets up a conversation we then have to walk back.

The Workflows page wasn't useful. Three dense paragraphs about renaming, pinning, archiving and moving sessions into group folders. Those features are real, but the page read as generic project-management filler and was far too technical for our audience.

What

  • Deleted both pages.
  • Removed the now-empty Run in the cloud nav group (shared-workspace was its only page).
  • Added redirects for both URLs so nothing 404s: → /cloud/get-started and → /start-here/do-work-with-it/skills-plugins-and-mcp.
  • Fixed every inbound link, which would otherwise have broken: the Shared workspaces bullet in cloud/get-started.mdx, the Cloud-primitives sentence in start-here/self-host.mdx (grammar repaired, not just the link removed), and the Cloud hub card in start-here/get-started.mdx that advertised hosted workers.

Verification

docs.json valid                     json ok
nav pages resolve on disk           48/48
internal markdown links             none broken
redirects for both removed URLs     present
git diff -- apps/ ee/ packages/types packages/ui   (empty — docs only)

No images were orphaned (both deleted pages referenced none — verified).

Docs-only, no runtime path — no fraimz.

@vercel

vercel Bot commented Jul 25, 2026

Copy link
Copy Markdown
Contributor

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
openwork-app Ready Ready Preview, Comment Jul 25, 2026 5:05pm
openwork-den Ready Ready Preview, Comment Jul 25, 2026 5:05pm
openwork-den-worker-proxy Ready Ready Preview, Comment Jul 25, 2026 5:05pm
openwork-diagnostics Ready Ready Preview, Comment Jul 25, 2026 5:05pm
openwork-landing Ready Ready Preview, Comment, Open in v0 Jul 25, 2026 5:05pm

@mintlify

mintlify Bot commented Jul 25, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
differentai 🟢 Ready View Preview Jul 25, 2026, 5:05 PM

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

@mintlify

mintlify Bot commented Jul 25, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
differentai 🟡 Building Jul 25, 2026, 5:04 PM

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

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.

1 participant