feat: flip to the v3 information architecture

.github/workflows/test.yaml

@@ -138,14 +138,14 @@ jobs:
                     assert_no_redirect "http://localhost:8080" --request-target '/\evil.com/'
                     assert_no_redirect "http://localhost:8080" --request-target '///\evil.com/'
                     # Normal trailing-slash redirect must still work
-                    assert_status "http://localhost:8080/platform/proxy/datacenter-proxy/" "302"
+                    assert_status "http://localhost:8080/proxy/datacenter-proxy/" "302"
 
                     echo "🧪 Checking Nginx responses... (apify-docs)"
                     assert_header "http://localhost:8080/" "Content-Type" "text/html"
                     assert_header "http://localhost:8080/" "Content-Type" "text/markdown" -H "Accept: text/markdown"
-                    assert_header "http://localhost:8080/platform/proxy/datacenter-proxy" "Content-Type" "text/html"
-                    assert_header "http://localhost:8080/platform/proxy/datacenter-proxy.md" "Content-Type" "text/markdown"
-                    assert_header "http://localhost:8080/platform/proxy/datacenter-proxy" "Content-Type" "text/markdown" -H "Accept: text/markdown"
+                    assert_header "http://localhost:8080/proxy/datacenter-proxy" "Content-Type" "text/html"
+                    assert_header "http://localhost:8080/proxy/datacenter-proxy.md" "Content-Type" "text/markdown"
+                    assert_header "http://localhost:8080/proxy/datacenter-proxy" "Content-Type" "text/markdown" -H "Accept: text/markdown"
                     assert_header "http://localhost:8080/img/docs-og.png" "Content-Type" "image/png"
                     assert_header "http://localhost:8080/img/javascript-40x40.svg" "Content-Type" "image/svg"
                     assert_header "http://localhost:8080/llms.txt" "Content-Type" "text/markdown"
@@ -172,7 +172,7 @@ jobs:
                     assert_html_md_alternate "http://localhost:8080/api/v2/dataset-get" "https://docs.apify.com/api/v2/dataset-get.md"
                     assert_html_md_alternate "http://localhost:8080/academy/tutorials" "https://docs.apify.com/academy/tutorials.md"
                     # Sanity check: a regular (non-excluded) page also has the alternate.
-                    assert_html_md_alternate "http://localhost:8080/platform/proxy/datacenter-proxy" "https://docs.apify.com/platform/proxy/datacenter-proxy.md"
+                    assert_html_md_alternate "http://localhost:8080/proxy/datacenter-proxy" "https://docs.apify.com/proxy/datacenter-proxy.md"
 
                     echo "🧪 Checking Nginx responses... (apify-sdk-js)"
                     assert_final_content_type "http://localhost:8080/sdk/js" "text/html"

apify-api/openapi/components/objects/actor-runs/charge.yaml

@@ -9,7 +9,7 @@ byRunId:
 
     :::info Learn more about pay-per-event pricing
 
-    For more details about pay-per-event (PPE) pricing, refer to our [PPE documentation](/platform/actors/publishing/monetize/pay-per-event).
+    For more details about pay-per-event (PPE) pricing, refer to our [PPE documentation](/actors/publishing/monetize/pay-per-event).
 
     :::
 

apify-api/openapi/components/parameters/datasetParameters.yaml

@@ -236,7 +236,7 @@ view:
   description: |
     Defines the view configuration for dataset items based on the schema definition.
     This parameter determines how the data will be filtered and presented.
-    For complete specification details, see the [dataset schema documentation](/platform/actors/development/actor-definition/dataset-schema).
+    For complete specification details, see the [dataset schema documentation](/actors/development/actor-definition/dataset-schema).
   schema:
     type: string
     example: overview

apify-api/openapi/components/schemas/actors/ActorDefinition.yaml

@@ -48,7 +48,7 @@ properties:
         examples: [get(input, startUrls.length, 1) * 1024]
       - type: integer
         examples: [1024]
-    description: Specifies the default amount of memory in megabytes to be used when the Actor is started. Can be an integer or a [dynamic memory expression](/platform/actors/development/actor-definition/dynamic-actor-memory).
+    description: Specifies the default amount of memory in megabytes to be used when the Actor is started. Can be an integer or a [dynamic memory expression](/actors/development/actor-definition/dynamic-actor-memory).
   minMemoryMbytes:
     type: integer
     minimum: 128

apify-api/openapi/components/schemas/datasets/Dataset.yaml

@@ -50,7 +50,7 @@ properties:
     description: ""
   schema:
     type: [object, "null"]
-    description: Defines the schema of items in your dataset, the full specification can be found in [Apify docs](/platform/actors/development/actor-definition/dataset-schema)
+    description: Defines the schema of items in your dataset, the full specification can be found in [Apify docs](/actors/development/actor-definition/dataset-schema)
     example:
       actorSpecification: 1
       title: My dataset

apify-docs-theme/src/config.js

@@ -20,119 +20,118 @@ const themeConfig = {
         },
         items: [
             {
-                label: 'Academy',
-                href: `${absoluteUrl}/academy`,
-                activeBasePath: 'academy',
+                label: 'Get started',
+                href: `${absoluteUrl}/get-started`,
+                activeBasePath: 'get-started',
                 position: 'left',
                 target: '_self',
                 rel: 'dofollow',
             },
             {
-                label: 'Platform',
-                href: `${absoluteUrl}/platform`,
-                className: 'navbar__active',
-                activeBasePath: 'platform',
+                label: 'Actors',
+                href: `${absoluteUrl}/actors`,
+                activeBasePath: 'actors',
                 position: 'left',
                 target: '_self',
                 rel: 'dofollow',
             },
             {
-                label: 'API',
-                type: 'dropdown',
-                to: `${absoluteUrl}/api`,
+                label: 'Storage',
+                href: `${absoluteUrl}/storage`,
+                activeBasePath: 'storage',
+                position: 'left',
                 target: '_self',
                 rel: 'dofollow',
-                activeBasePath: 'api',
+            },
+            {
+                label: 'Proxy',
+                href: `${absoluteUrl}/proxy`,
+                activeBasePath: 'proxy',
                 position: 'left',
-                items: [
-                    {
-                        label: 'Reference',
-                        href: `${absoluteUrl}/api/v2`,
-                        target: '_self',
-                        rel: 'dofollow',
-                    },
-                    {
-                        label: 'Client for JavaScript',
-                        href: `${absoluteUrl}/api/client/js/docs`,
-                        target: '_self',
-                        rel: 'dofollow',
-                    },
-                    {
-                        label: 'Client for Python',
-                        href: `${absoluteUrl}/api/client/python/docs`,
-                        target: '_self',
-                        rel: 'dofollow',
-                    },
-                ],
+                target: '_self',
+                rel: 'dofollow',
             },
             {
-                label: 'SDK',
-                type: 'dropdown',
-                to: `${absoluteUrl}/sdk`,
-                activeBasePath: 'sdk',
+                label: 'Account',
+                href: `${absoluteUrl}/account`,
+                activeBasePath: 'account',
                 position: 'left',
                 target: '_self',
                 rel: 'dofollow',
-                items: [
-                    {
-                        label: 'SDK for JavaScript',
-                        href: `${absoluteUrl}/sdk/js/docs/overview`,
-                        target: '_self',
-                        rel: 'dofollow',
-                    },
-                    {
-                        html: 'SDK for Python',
-                        href: `${absoluteUrl}/sdk/python/docs/overview`,
-                        target: '_self',
-                        rel: 'dofollow',
-                    },
-                ],
             },
             {
-                label: 'CLI',
-                href: `${absoluteUrl}/cli/docs`,
+                label: 'Integrations',
+                href: `${absoluteUrl}/integrations`,
+                activeBasePath: 'integrations',
                 position: 'left',
-                activeBasePath: 'cli',
                 target: '_self',
                 rel: 'dofollow',
             },
             {
-                label: 'Open source',
-                type: 'dropdown',
-                to: `${absoluteUrl}/open-source`,
-                activeBasePath: 'open-source',
+                label: 'Limits',
+                href: `${absoluteUrl}/limits`,
+                activeBasePath: 'limits',
+                position: 'left',
                 target: '_self',
+                rel: 'dofollow',
+            },
+            {
+                label: 'Security',
+                href: `${absoluteUrl}/security`,
+                activeBasePath: 'security',
                 position: 'left',
-                className: 'navbar__item',
+                target: '_self',
+                rel: 'dofollow',
+            },
+            {
+                label: 'Academy',
+                href: `${absoluteUrl}/academy`,
+                activeBasePath: 'academy',
+                position: 'right',
+                target: '_self',
+                rel: 'dofollow',
+            },
+            {
+                label: 'APIs, SDKs & CLI',
+                type: 'dropdown',
+                activeBaseRegex: '^/(api|sdk|cli)/',
+                position: 'right',
                 items: [
                     {
-                        label: 'Crawlee',
-                        href: 'https://crawlee.dev',
+                        label: 'API Reference',
+                        href: `${absoluteUrl}/api/v2`,
+                        target: '_self',
                         rel: 'dofollow',
                     },
                     {
-                        label: 'Fingerprint Suite',
-                        href: 'https://github.com/apify/fingerprint-suite',
-                    },
-                    {
-                        label: 'impit',
-                        href: 'https://github.com/apify/impit',
+                        label: 'SDK for JavaScript',
+                        href: `${absoluteUrl}/sdk/js/docs/overview`,
+                        target: '_self',
+                        rel: 'dofollow',
                     },
                     {
-                        label: 'MCP CLI',
-                        href: 'https://github.com/apify/mcpc',
+                        label: 'SDK for Python',
+                        href: `${absoluteUrl}/sdk/python/docs/overview`,
+                        target: '_self',
+                        rel: 'dofollow',
                     },
                     {
-                        label: 'Actor whitepaper',
-                        href: 'https://whitepaper.actor',
+                        label: 'Client for JavaScript',
+                        href: `${absoluteUrl}/api/client/js/docs`,
+                        target: '_self',
+                        rel: 'dofollow',
                     },
                     {
-                        label: 'proxy-chain',
-                        href: 'https://github.com/apify/proxy-chain',
+                        label: 'Client for Python',
+                        href: `${absoluteUrl}/api/client/python/docs`,
+                        target: '_self',
+                        rel: 'dofollow',
                     },
                     {
-                        label: 'Apify on GitHub',
-                        href: 'https://github.com/apify',
+                        label: 'CLI',
+                        href: `${absoluteUrl}/cli/docs`,
+                        target: '_self',
+                        rel: 'dofollow',
                     },
                 ],
             },
@@ -163,8 +162,14 @@ const themeConfig = {
                         rel: 'dofollow',
                     },
                     {
-                        label: 'Platform',
-                        href: `${absoluteUrl}/platform`,
+                        label: 'Get started',
+                        href: `${absoluteUrl}/get-started`,
+                        target: '_self',
+                        rel: 'dofollow',
+                    },
+                    {
+                        label: 'Actors',
+                        href: `${absoluteUrl}/actors`,
                         target: '_self',
                         rel: 'dofollow',
                     },
@@ -211,18 +216,45 @@ const themeConfig = {
                 ],
             },
             {
-                title: 'Other',
+                title: 'Open source',
                 items: [
                     {
-                        label: 'CLI',
-                        href: `${absoluteUrl}/cli/docs`,
-                        position: 'left',
-                        target: '_self',
+                        label: 'Crawlee',
+                        href: 'https://crawlee.dev',
                         rel: 'dofollow',
                     },
                     {
-                        label: 'Open source',
-                        href: `${absoluteUrl}/open-source`,
+                        label: 'Fingerprint Suite',
+                        href: 'https://github.com/apify/fingerprint-suite',
+                    },
+                    {
+                        label: 'impit',
+                        href: 'https://github.com/apify/impit',
+                    },
+                    {
+                        label: 'MCP CLI',
+                        href: 'https://github.com/apify/mcpc',
+                    },
+                    {
+                        label: 'Actor whitepaper',
+                        href: 'https://whitepaper.actor',
+                    },
+                    {
+                        label: 'proxy-chain',
+                        href: 'https://github.com/apify/proxy-chain',
+                    },
+                    {
+                        label: 'Apify on GitHub',
+                        href: 'https://github.com/apify',
+                    },
+                ],
+            },
+            {
+                title: 'Other',
+                items: [
+                    {
+                        label: 'CLI',
+                        href: `${absoluteUrl}/cli/docs`,
                         position: 'left',
                         target: '_self',
                         rel: 'dofollow',

apify-docs-theme/src/theme/DocItemContent/index.js

@@ -51,7 +51,14 @@ export default function DocItemContent({ children }) {
         '/api/v2/logs',
         '/api/v2/users',
         '/api/client',
-        '/platform',
+        '/get-started',
+        '/actors',
+        '/storage',
+        '/proxy',
+        '/account',
+        '/integrations',
+        '/limits',
+        '/security',
         '/sdk',
         '/cli',
         '/academy',

apify-docs-theme/src/theme/SearchBar/index.js

@@ -17,7 +17,17 @@ import './styles.css';
  */
 function matchesCurrentInstance(href, baseUrl) {
     if (baseUrl === '/') {
-        return href.startsWith('/academy') || href.startsWith('/platform');
+        return (
+            href.startsWith('/academy') ||
+            href.startsWith('/get-started') ||
+            href.startsWith('/actors') ||
+            href.startsWith('/storage') ||
+            href.startsWith('/proxy') ||
+            href.startsWith('/account') ||
+            href.startsWith('/integrations') ||
+            href.startsWith('/limits') ||
+            href.startsWith('/security')
+        );
     }
 
     return href.startsWith(baseUrl);

docusaurus.config.js

@@ -120,7 +120,7 @@ module.exports = {
                     showLastUpdateTime: false,
                     editUrl: 'https://github.com/apify/apify-docs/edit/master/',
                     path: './sources/platform',
-                    routeBasePath: 'platform',
+                    routeBasePath: '/',
                     sidebarPath: require.resolve('./sources/platform/sidebars.js'),
                     rehypePlugins: [externalLinkProcessor],
                 },