Skip to content

docs: IA stage 2#2272

Draft
TC-MO wants to merge 10 commits intomasterfrom
IA-test---stage-2
Draft

docs: IA stage 2#2272
TC-MO wants to merge 10 commits intomasterfrom
IA-test---stage-2

Conversation

@TC-MO
Copy link
Contributor

@TC-MO TC-MO commented Feb 23, 2026

Summary

Restructures the platform documentation into a two-zone navigation mode.

Nav structure:
Product: Get Started | Actors | Integrations | Account | Resources ▼ · Ecosystem: Learn | Open Source ▼

What changed

  • Directory restructure (~151 files moved): Quick Start → Get Started, Console + Collaboration → Account, Storage/Proxy nested under Actors, Schedules/Monitoring nested under Actors > Running, schema directories flattened
  • Per-section sidebars: Single sidebars.js with named sidebars (getStarted, actors, integrations, account)
    replacing the monolithic sidebar
  • Two-zone navbar + footer: Product zone (Get Started, Actors, Integrations, Account, Resources dropdown) and Ecosystem zone (Learn, Open Source dropdown) with CSS zone separator
  • Resources in product zone: API ref, SDKs, Clients, CLI are first-party product tools - placed in the product zone, not
    ecosystem
  • Cross-references updated (~51 files): Internal links across platform and academy docs, ~25 new nginx redirects, homepage content updated
  • Get Started placeholder pages (4 new): Choose and run an Actor, Connect AI agents, Automate workflows, Apify platform basics (placeholder content, real copy TBD)
  • Standalone pages: Security and Limits removed from sidebar, accessible via footer and search only

Commit structure

  1. 9963d862 - File moves + front matter updates (151 files)
  2. c31de484 - Per-section sidebars
  3. 05627f28 - Two-zone navbar, footer, CSS zone separator
  4. cbbfaee0 - Cross-references, nginx redirects, homepage (51 files)
  5. eddca697 - Placeholder pages for Get Started section
  6. 7cc50d3e - Move Resources dropdown to product zone

What's NOT in this PR

  • Real content for Get Started placeholder pages (Phase 2)
  • Homepage redesign (Phase 2)
  • Open Source section content (Phase 2)
  • Academy dissolution into Learn (Phase 3 - separate effort)
  • URL prefix removal or slug cleanup (post-Phase 1)

Test plan

  • Build passes (npm run build) - verified locally, no broken links
  • All nginx redirects resolve correctly
  • Navbar renders two zones with visual separator
  • Each section sidebar loads correctly (get-started, actors, integrations, account)
  • Security and Limits pages accessible via footer links and direct URL
  • Resources dropdown appears in product zone (after Account)
  • Open Source dropdown appears in ecosystem zone
  • Academy/Learn tab and sidebar still functional

TC-MO and others added 6 commits February 21, 2026 03:49
Move files to implement two-zone navigation model:

- Get Started: move quick-start from actors/development/ to get-started/build-an-actor/
- Account: merge console/ and collaboration/ into account/, add organization/ subdir
- Storage: nest under actors/storage/ (was top-level)
- Proxy: nest under actors/proxy/ (was top-level)
- Schedules: move from platform root to actors/running/
- Monitoring: move from monitoring/ to actors/running/
- Input/output schemas: flatten 3 subdirs (input_schema/, output_schema/,
  dataset_schema/, key_value_store_schema/) into input_output_schemas/
- Delete collaboration/index.md (replaced by account/index.md)

Create new index pages for get-started/ and account/ sections.
Update front matter (slug, sidebar_position) in all moved files.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Replace single autogenerated sidebar with four named sidebars
(getStarted, actors, integrations, account) so each top nav tab
shows only its own section's pages.

Root-level files (security.md, limits.md) are intentionally excluded
from all sidebars - they remain accessible via URL, search, and footer.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Navbar: replace flat tab list with two-zone model:
- Product zone (left): Get Started, Actors, Integrations, Account
- Ecosystem zone (right): Learn, Open Source dropdown, Resources dropdown
- Resources dropdown consolidates API reference, SDKs, Clients, CLI
- Visual separator between zones via CSS class

Footer: restructure into four columns:
- Product (Get Started, Actors, Integrations, Account)
- Developer tools (API Reference, SDKs, CLI)
- Learn & community (Academy, Crawlee, GitHub, Discord)
- Company (Security, Limits, Trust Center)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Update internal links across ~89 files to reflect new paths:
- /platform/storage > /platform/actors/storage
- /platform/proxy > /platform/actors/proxy
- /platform/schedules > /platform/actors/running/schedules
- /platform/monitoring > /platform/actors/running/monitoring
- /platform/console > /platform/account
- /platform/collaboration > /platform/account
- Schema paths from actor-definition/ to input-output-schemas/
- Quick-start paths to get-started/build-an-actor/

nginx.conf: add IA v2 redirect block for moved pages, update existing
legacy redirects to point to new paths (storage, proxy, schedules,
monitoring, collaboration > account, schema flattening).

Academy: update 16 files with links to moved platform content.
Homepage: update section links to match new nav structure.
Security/Limits: remove sidebar_position (standalone pages).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Create four placeholder pages with proper front matter and lorem ipsum
body content for Phase 2 writing:

- Choose and run an Actor (sidebar_position: 1)
- Connect AI agents (sidebar_position: 3)
- Automate workflows (sidebar_position: 4)
- Apify platform basics (sidebar_position: 5)

Each page has TODO comments marking placeholder content. Update Get
Started index to link to all five pathways.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Resources (API ref, SDKs, Clients, CLI) are first-party product tools,
not ecosystem content. Move the dropdown from the ecosystem zone (after
Open Source) to the product zone (after Account) for semantic accuracy.

Nav order: Get Started | Actors | Integrations | Account | Resources ▼ · Learn | Open Source

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@TC-MO TC-MO self-assigned this Feb 23, 2026
@TC-MO TC-MO added documentation Improvements or additions to documentation. t-docs Issues owned by technical writing team. labels Feb 23, 2026
@TC-MO TC-MO changed the title docs:Ia test stage 2 docs: IA stage 2 Feb 23, 2026
@apify-service-account
Copy link

Preview for this PR was built for commit 7cc50d3e and is ready at https://pr-2272.preview.docs.apify.com!

Fix table separator row spacing and trailing whitespace in
environment_variables.md to pass CI markdownlint check.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@apify-service-account
Copy link

Preview for this PR was built for commit 406f7486 and is ready at https://pr-2272.preview.docs.apify.com!

TC-MO and others added 2 commits February 24, 2026 00:57
NavbarNavLink.jsx was overwriting the className prop with its own
computed active/inactive classes when items had href + activeBasePath.
This discarded any custom className from config (like the zone separator).
Now merges both class names together.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@apify-service-account
Copy link

Preview for this PR was built for commit 66f6267b and is ready at https://pr-2272.preview.docs.apify.com!

@apify-service-account
Copy link

Preview for this PR was built for commit a942347a and is ready at https://pr-2272.preview.docs.apify.com!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation. t-docs Issues owned by technical writing team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants