feat: revert " flip to the v3 information architecture (#2702)"

.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/proxy/datacenter-proxy/" "302"
+                    assert_status "http://localhost:8080/platform/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/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/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/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/proxy/datacenter-proxy" "https://docs.apify.com/proxy/datacenter-proxy.md"
+                    assert_html_md_alternate "http://localhost:8080/platform/proxy/datacenter-proxy" "https://docs.apify.com/platform/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](/actors/publishing/monetize/pay-per-event).
+    For more details about pay-per-event (PPE) pricing, refer to our [PPE documentation](/platform/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](/actors/development/actor-definition/dataset-schema).
+    For complete specification details, see the [dataset schema documentation](/platform/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](/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](/platform/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](/actors/development/actor-definition/dataset-schema)
+    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)
     example:
       actorSpecification: 1
       title: My dataset

apify-api/openapi/components/schemas/users/UpdateLimitsRequest.yaml

@@ -10,4 +10,4 @@ properties:
     type: integer
     examples: [90]
     description: |
-      Apify securely stores your ten most recent Actor runs indefinitely, ensuring they are always accessible. Unnamed storages and other Actor runs are automatically deleted after the retention period. If you're subscribed, you can change it to keep data for longer or to limit your usage. [Lear more](https://docs.apify.com/storage#data-retention).
+      Apify securely stores your ten most recent Actor runs indefinitely, ensuring they are always accessible. Unnamed storages and other Actor runs are automatically deleted after the retention period. If you're subscribed, you can change it to keep data for longer or to limit your usage. [Lear more](https://docs.apify.com/platform/storage/usage#data-retention).

apify-docs-theme/src/config.js

@@ -20,118 +20,119 @@ const themeConfig = {
         },
         items: [
             {
-                label: 'Get started',
-                href: `${absoluteUrl}/get-started`,
-                activeBasePath: 'get-started',
+                label: 'Academy',
+                href: `${absoluteUrl}/academy`,
+                activeBasePath: 'academy',
                 position: 'left',
                 target: '_self',
                 rel: 'dofollow',
             },
             {
-                label: 'Actors',
-                href: `${absoluteUrl}/actors`,
-                activeBasePath: 'actors',
+                label: 'Platform',
+                href: `${absoluteUrl}/platform`,
+                className: 'navbar__active',
+                activeBasePath: 'platform',
                 position: 'left',
                 target: '_self',
                 rel: 'dofollow',
             },
             {
-                label: 'Storage',
-                href: `${absoluteUrl}/storage`,
-                activeBasePath: 'storage',
-                position: 'left',
+                label: 'API',
+                type: 'dropdown',
+                to: `${absoluteUrl}/api`,
                 target: '_self',
                 rel: 'dofollow',
-            },
-            {
-                label: 'Proxy',
-                href: `${absoluteUrl}/proxy`,
-                activeBasePath: 'proxy',
+                activeBasePath: 'api',
                 position: 'left',
-                target: '_self',
-                rel: 'dofollow',
+                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',
+                    },
+                ],
             },
             {
-                label: 'Account',
-                href: `${absoluteUrl}/account`,
-                activeBasePath: 'account',
+                label: 'SDK',
+                type: 'dropdown',
+                to: `${absoluteUrl}/sdk`,
+                activeBasePath: 'sdk',
                 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: 'Integrations',
-                href: `${absoluteUrl}/integrations`,
-                activeBasePath: 'integrations',
+                label: 'CLI',
+                href: `${absoluteUrl}/cli/docs`,
                 position: 'left',
+                activeBasePath: 'cli',
                 target: '_self',
                 rel: 'dofollow',
             },
             {
-                label: 'Limits',
-                href: `${absoluteUrl}/limits`,
-                activeBasePath: 'limits',
-                position: 'left',
+                label: 'Open source',
+                type: 'dropdown',
+                to: `${absoluteUrl}/open-source`,
+                activeBasePath: 'open-source',
                 target: '_self',
-                rel: 'dofollow',
-            },
-            {
-                label: 'Security',
-                href: `${absoluteUrl}/security`,
-                activeBasePath: 'security',
                 position: 'left',
-                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',
+                className: 'navbar__item',
                 items: [
                     {
-                        label: 'API Reference',
-                        href: `${absoluteUrl}/api/v2`,
-                        target: '_self',
+                        label: 'Crawlee',
+                        href: 'https://crawlee.dev',
                         rel: 'dofollow',
                     },
                     {
-                        label: 'SDK for JavaScript',
-                        href: `${absoluteUrl}/sdk/js/docs/overview`,
-                        target: '_self',
-                        rel: 'dofollow',
+                        label: 'Fingerprint Suite',
+                        href: 'https://github.com/apify/fingerprint-suite',
                     },
                     {
-                        label: 'SDK for Python',
-                        href: `${absoluteUrl}/sdk/python/docs/overview`,
-                        target: '_self',
-                        rel: 'dofollow',
+                        label: 'impit',
+                        href: 'https://github.com/apify/impit',
                     },
                     {
-                        label: 'Client for JavaScript',
-                        href: `${absoluteUrl}/api/client/js/docs`,
-                        target: '_self',
-                        rel: 'dofollow',
+                        label: 'MCP CLI',
+                        href: 'https://github.com/apify/mcpc',
                     },
                     {
-                        label: 'Client for Python',
-                        href: `${absoluteUrl}/api/client/python/docs`,
-                        target: '_self',
-                        rel: 'dofollow',
+                        label: 'Actor whitepaper',
+                        href: 'https://whitepaper.actor',
                     },
                     {
-                        label: 'CLI',
-                        href: `${absoluteUrl}/cli/docs`,
-                        target: '_self',
-                        rel: 'dofollow',
+                        label: 'proxy-chain',
+                        href: 'https://github.com/apify/proxy-chain',
+                    },
+                    {
+                        label: 'Apify on GitHub',
+                        href: 'https://github.com/apify',
                     },
                 ],
             },
@@ -162,14 +163,8 @@ const themeConfig = {
                         rel: 'dofollow',
                     },
                     {
-                        label: 'Get started',
-                        href: `${absoluteUrl}/get-started`,
-                        target: '_self',
-                        rel: 'dofollow',
-                    },
-                    {
-                        label: 'Actors',
-                        href: `${absoluteUrl}/actors`,
+                        label: 'Platform',
+                        href: `${absoluteUrl}/platform`,
                         target: '_self',
                         rel: 'dofollow',
                     },
@@ -215,40 +210,6 @@ const themeConfig = {
                     },
                 ],
             },
-            {
-                title: 'Open source',
-                items: [
-                    {
-                        label: 'Crawlee',
-                        href: 'https://crawlee.dev',
-                        rel: 'dofollow',
-                    },
-                    {
-                        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: [
@@ -259,6 +220,13 @@ const themeConfig = {
                         target: '_self',
                         rel: 'dofollow',
                     },
+                    {
+                        label: 'Open source',
+                        href: `${absoluteUrl}/open-source`,
+                        position: 'left',
+                        target: '_self',
+                        rel: 'dofollow',
+                    },
                     {
                         label: 'llms.txt',
                         href: `${absoluteUrl}/llms.txt`,

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

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

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

@@ -17,17 +17,7 @@ import './styles.css';
  */
 function matchesCurrentInstance(href, baseUrl) {
     if (baseUrl === '/') {
-        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('/academy') || href.startsWith('/platform');
     }
 
     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: '/',
+                    routeBasePath: 'platform',
                     sidebarPath: require.resolve('./sources/platform/sidebars.js'),
                     rehypePlugins: [externalLinkProcessor],
                 },