feat: ia v3 flip#2745
Merged
Merged
Conversation
Relocate sections to match the v3 IA: - console pages fold into Account (/account/*), console index -> /account/console - collaboration folds under Account (/account/collaboration/*), organization_account renamed to organization - schedules and monitoring move under Actors > running (/actors/running/*) - schedule and monitoring images move alongside their pages Add the Account hub (/account) and the opinionated Get Started section (/get-started: locally, web-ide, build-with-ai, develop-ai-agents).
With routeBasePath moving to root, rewrite /platform/* references to /* across authored content, the OpenAPI source components (charge.yaml, Dataset.yaml, ActorDefinition.yaml, datasetParameters.yaml), and the custom React pages. Move-aware: links into relocated sections point at their new v3 paths (e.g. /account/*, /actors/running/*).
- docusaurus.config.js: routeBasePath 'platform' -> '/' - config.js: swap navbar.items to the v3 set (Get started, Actors, Storage, Proxy, Account, Integrations, Limits, Security | Academy, APIs, SDKs & CLI); move Open source from a nav dropdown to a footer column - sources/platform/sidebars.js: per-section autogenerated sidebars
Point DocItemContent's allowed paths and the SearchBar instance check at the eight v3 section roots instead of the single /platform tree.
The docs root is now the entry point (src/pages/index.tsx); the old /platform index page collided with slug: / after the routeBasePath flip.
Add an nginx block with a /platform/* -> /* catch-all plus structural pre-rules for relocated sections (console -> account, collaboration, schedules/monitoring -> actors/running, quick-start -> get-started, airtable console-integration soft-land, /platform root). console/store keeps its URL pending the open store-page decision. Stripping /platform/ from existing rule targets (double-hop cleanup) is left to a follow-up PR; those URLs still resolve via the catch-all.
The Actors, Storage, Proxy, and Integrations hub pages kept their old single-sidebar positions and had no sidebar_label, so they showed the section name and (for Integrations) sorted mid-list. Add sidebar_label: Overview and sidebar_position: 0 to match Account and Get started.
The dedicated Open source footer column makes the Open source link in the Other column redundant.
Now that Get Started covers two journeys, give them structure: - move "Apify for AI agents" from Integrations into Get Started as the top-level "Agent onboarding" page (the consume-Apify path) - group the four build pages (Local development, Web IDE, Build with AI, Develop AI agents) under an expanded "Build" category (the build-on-Apify path); they keep their flat /get-started/* slugs The page moved out of Integrations, so redirect its live URL and update inbound links. The directory is named building/ because a bare "build" is gitignored (Docusaurus output dir).
The quick start pages duplicated the new Get Started build pages (same content, different URLs). Delete the tree and migrate its unique "Technology stack" intro into the Actor development overview, which also gives that section a proper opening now that quick start no longer leads it. Repoint inbound links to Get Started; old /platform quick-start URLs already redirect there via nginx.
The header-assertion smoke test used /platform/proxy/datacenter-proxy as its sample page; after the flip that 301s to /proxy/datacenter-proxy, so the trailing-slash, Content-Type, and .md-alternate assertions now target the v3 URL.
Dropping the /platform prefix shortened link cells in two tables, pushing their closing pipes out of alignment (markdownlint MD060). Re-pad to match.
Vale flagged them once the flip's link rewrite brought these files into the changed-file set.
The repo kept pre-/platform aliases like `^/proxy$ -> /platform/proxy` and `^/storage/dataset$ -> /platform/storage/dataset` from before the docs used a /platform prefix. The flip drops that prefix, so those source paths are now the canonical v3 URLs and serve directly. Combined with the new `/platform/* -> /*` catch-all they formed 301 loops (`/proxy -> /platform/proxy -> /proxy`), which broke the header-assertion smoke test (`/proxy/datacenter-proxy` no longer served its page). Remove the 19 aliases whose path now exists as a v3 route (one targeted an anchor: `/actors/running/input-and-output`). /monitoring and /schedules are kept - their pages moved under /actors/running, so they still redirect. Verified with a redirect-chain simulator: 0 loops and 0 gaps across all 347 literal redirect sources and the 165 production /platform URLs.
The smoke test in checkNavHeaders.mjs sampled hardcoded /platform/*.md pages; after the flip those 404 or live at the v3 path. Repoint them and drop /platform.md (the platform root landing is gone; its key combo is already covered by /academy, /api, /legal). In the v3 per-section sidebars a section landing (/actors, /storage, /integrations) is the first item and a sibling link, so it carries only `next` - no `previous` (nothing before it) and no `children` (its sub-pages are siblings, not nested). The `children` combo stays covered by /actors/running and /api/v2. Verified against locally generated headers.
- navbar: drop `to`/`target`/`rel` from the "APIs, SDKs & CLI" dropdown so tapping the label opens the menu on touchscreens instead of navigating straight to /api/v2 (children were unreachable on mobile) - navbar: switch activeBasePath:'api' to activeBaseRegex '^/(api|sdk|cli)/' so the item highlights across all three child destinations - restore "Tool/platform" in the LinkedIn prompt template (the /platform link rewrite stripped it to "Tool/")
Get Started pages are parallel entry points (agent onboarding plus the Build group's alternative ways to start), not a sequential course. The sidebar pagination threaded them as if they were steps, so disable it via pagination_next/pagination_prev: null on each page.
# Conflicts: # sources/platform/actors/development/programming_interface/environment_variables.md
- restore /img/platform/integrations/ icon paths across 7 integration index pages (the /platform link rewrite wrongly stripped them, 404ing 56 icons) - fix the platform-usage-costs anchor in how_actor_monetization_works.md (was the stale #pass-platform-usage-to-users)
/platform/storage/usage merged into the /storage hub, so after the flip's redirects the old link would 404 at /storage/usage. Point it straight at /storage#data-retention.
Move the build-path routing out of the Get started overview into a new /get-started/build landing (intro + card grid), so the Build sidebar category is clickable and the routing isn't duplicated across both pages.
TC-MO
added
documentation
Contributor
|
🗑️ Preview for this PR was deleted. |
Contributor
|
Important Action required — @TC-MO please coordinate this docs PR with the Python API client PR linked below. Because this PR modifies the OpenAPI specification, the generated models in A companion PR has been opened in
|
TC-MO
requested review from
fnesveda,
honzajavorek,
janbuchar,
marcel-rbro and
szaganek
as code owners
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Re-applies the IA v3 flip (
/platform/*→ root) after #2702 shipped, and was reverted (#2713). The root cause was nginx deploy propagation, not this config and has since been fixed.