Skip to content

feat: IA v3 clean slate#2516

Draft
TC-MO wants to merge 10 commits into
masterfrom
ia-v3-preview
Draft

feat: IA v3 clean slate#2516
TC-MO wants to merge 10 commits into
masterfrom
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
@apify-service-account
Copy link
Copy Markdown
Contributor

apify-service-account commented May 11, 2026

✅ Preview for this PR (commit c9879f6) is ready at https://pr-2516.preview.docs.apify.com (see action run).

TC-MO added 2 commits May 21, 2026 21:18
Move primary navigation below the logo on its own full-width row.
Top row holds the logo and utilities (search, Ask AI, Discord, Console
CTA); nav row holds product items on the left and APIs & SDKs on the
right. Open source moves out of the navbar into a dedicated footer
column. Mobile collapses to a single row (hamburger).
Move /account/limits and /account/security up to /limits and /security
and add nav items for them on the product side of the top nav. Remove
the corresponding cards from the Account hub.
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