feat: flip to the v3 information architecture#2702
Open
TC-MO wants to merge 15 commits into
Open
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.
TC-MO
added
documentation
Contributor
|
✅ Preview for this PR (commit |
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
|
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.
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
2 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.
Switches the docs from the
/platform/*URL structure to the v3 information architecture: topic-first sections at the site root,routeBasePathdropped to/, and 301 redirects covering old URLs.Review by commit
The flip is categorized by concern; commits 1-2 are mechanical (bulk moves and link rewrites) and can be skimmed, the judgment lives in 3-6. Commits 7-10 are refinements from reviewing the live preview.
DocItemContentallowed paths and theSearchBarinstance check.Verification
Build green at the tip, 0 broken links. The broken-anchor warnings are pre-existing and non-blocking (
onBrokenAnchors: 'warn').nginx double-hop cleanup - stripping
/platform/from the ~135 existing rule targets is a separate post-flip PR; those URLs still resolve via the catch-all in the meantime, just with an extra hop.