Skip to content

feat: IA v3 clean slate#2516

Draft
TC-MO wants to merge 8 commits intomasterfrom
ia-v3-preview
Draft

feat: IA v3 clean slate#2516
TC-MO wants to merge 8 commits intomasterfrom
ia-v3-preview

Conversation

@TC-MO
Copy link
Copy Markdown
Contributor

@TC-MO TC-MO commented May 9, 2026

  • restructure platform docs, drop /platform/… prefix
  • Move actors/development/quick-start/ → get-started/build-an-actor/
  • Move storage/, proxy/ under actors/
  • Move schedules.md, monitoring.md under actors/running/
  • Flatten console/ into account/ (billing, store, settings, console, 2FA)
  • Move collaboration/ → account/collaboration/, organization_account → organization
  • Move security.md, limits.md → account/, promoted in sidebar (sidebar_position)
  • Drop /platform/ URL prefix: routeBasePath: 'platform' → '/'
  • Update slugs in all moved files to new IA paths (no /platform/)
  • Update relative cross-references in 100+ markdown files
  • Rewrite homepage_content.json + src/pages/index.tsx links
  • Add named sidebars (getStarted, actors, integrations, account)
  • Add 17 category.json files for collapsed categories with v3 labels
    (Develop, Run and manage, Publish and monetize, AI and LLMs, etc.)
  • Add get-started/index.mdx and account/index.mdx as router pages
  • Relax onBrokenMarkdownLinks/Images and onBrokenLinks to warn (preview)
  • Move orphan images alongside their content (proxy, storage, schedules)
  • Delete sources/platform/index.mdx (homepage now src/pages/index.tsx only)

TC-MO added 7 commits May 9, 2026 02:08
…prefix

- Move actors/development/quick-start/ → get-started/build-an-actor/
- Move storage/, proxy/ under actors/
- Move schedules.md, monitoring.md under actors/running/
- Flatten console/ into account/ (billing, store, settings, console, 2FA)
- Move collaboration/ → account/collaboration/, organization_account → organization
- Move security.md, limits.md → account/, promoted in sidebar (sidebar_position)
- Drop /platform/ URL prefix: routeBasePath: 'platform' → '/'
- Update slugs in all moved files to new IA paths (no /platform/)
- Update relative cross-references in 100+ markdown files
- Rewrite homepage_content.json + src/pages/index.tsx links
- Add named sidebars (getStarted, actors, integrations, account)
- Add 17 _category_.json files for collapsed categories with v3 labels
  (Develop, Run and manage, Publish and monetize, AI and LLMs, etc.)
- Add get-started/index.mdx and account/index.mdx as router pages
- Relax onBrokenMarkdownLinks/Images and onBrokenLinks to warn (preview)
- Move orphan images alongside their content (proxy, storage, schedules)
- Delete sources/platform/index.mdx (homepage now src/pages/index.tsx only)
…ations/Account, consolidate API/SDK/CLI into APIs & SDKs

- Replace 6-item nav (Academy | Platform | API ▼ | SDK ▼ | CLI | Open source ▼)
  with 7-item v3 nav split across PRODUCT (left) and ECOSYSTEM (right) zones:
  PRODUCT:   Get started | Actors | Integrations | Account | APIs & SDKs ▼
  ECOSYSTEM: Academy | Open source ▼
- APIs & SDKs dropdown bundles: API Reference, SDK for JS, SDK for Python,
  Client for JS, Client for Python, CLI
- Move Academy and Open source to position: 'right'
- Update SearchBar matchesCurrentInstance to recognize new top-level paths
- Update DocItemContent allowedPaths for LLMButtons (drop /platform, add new)
- Update footer Learn section: replace Platform link with Get started + Actors
Index pages had legacy global positions (7, 7.4, 10, 11, etc.) inherited
from the old single-sidebar Platform layout. With per-section named
sidebars, those values pushed overview pages below their sibling
categories. Reset every index.md/index.mdx under sources/platform/ to 0
so Section overviews appear first within each sidebar.
Source files referenced /img/platform/integrations/X.svg and the perl
substitution that dropped /platform/ from URLs rewrote those to
/img/integrations/X.svg. The static files still lived at
static/img/platform/integrations/ so the new paths 404'd. Move the 44
icon files to static/img/integrations/ to align.
Master had .yml versions with pre-v3 labels and positions ('AI' at 6
instead of 'AI and LLMs' at 1, 'Workflows & notifications' instead of
'Workflows and notifications', etc.). The v3 commit added .json
versions with current labels but didn't remove the old .yml. Both
existing leaves the source-of-truth ambiguous.
@github-actions github-actions Bot added the t-docs Issues owned by technical writing team. label May 9, 2026
- test.yaml: update header-assertion URLs from /platform/proxy/usage to
  /actors/proxy/usage to match the new IA paths.
- apify-docs-theme/src/theme/SearchBar/index.js: oxfmt formatting
  (operators trailing rather than leading) after the v3 nav-paths edit.
- sources/platform/account/security.md: replace hard tabs with 2-space
  indentation in nested lists. Pre-existing issue on master, surfaced
  now because the file moved (path counted as changed in CI).
- sources/platform/integrations/programming/webhooks/actions.md:
  re-pad the eventType/eventData rows so trailing pipes align with the
  rest of the table. The /platform-prefix drop shortened those URLs by
  9 characters and broke MD060 alignment.
@TC-MO TC-MO changed the title feat: IA v3 clean slate - restructure platform docs, drop /platform/ … feat: IA v3 clean slate May 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

t-docs Issues owned by technical writing team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants