Revamp docs navigation into subsites

docs/additional-resources/_toc.json

@@ -0,0 +1,171 @@
+{
+  "parentUrl": "/docs/guides",
+  "parentLabel": "Documentation",
+  "title": "Additional resources",
+  "collapsed": true,
+  "children": [
+    {
+      "title": "Additional resources",
+      "url": "/docs/additional-resources"
+    },
+    {
+      "title": "Support and FAQ",
+      "children": [
+        {
+          "title": "Support",
+          "url": "/docs/additional-resources/support"
+        },
+        {
+          "title": "Frequently-asked questions",
+          "url": "/docs/additional-resources/faq"
+        }
+      ]
+    },
+    {
+      "title": "Development workflow",
+      "url": "/docs/additional-resources/intro-to-patterns"
+    },
+    {
+      "title": "Migration guides",
+      "children": [
+        {
+          "title": "Migrate to Qiskit 2.0",
+          "children": [
+            {
+              "title": "Qiskit v2.0 migration guide",
+              "url": "/docs/additional-resources/qiskit-2.0"
+            },
+            {
+              "title": "Migrate from BackendV1 to BackendV2",
+              "url": "/docs/additional-resources/qiskit-backendv1-to-v2"
+            }
+          ]
+        },
+        {
+          "title": "Migrate to Qiskit 1.0",
+          "children": [
+            {
+              "title": "Introduction",
+              "url": "/docs/additional-resources/qiskit-1.0"
+            },
+            {
+              "title": "Understand the breaking package changes",
+              "url": "/docs/additional-resources/metapackage-migration"
+            },
+            {
+              "title": "Install the new Qiskit v1.0 package",
+              "url": "/docs/additional-resources/qiskit-1.0-installation"
+            },
+            {
+              "title": "Qiskit v1.0 feature changes",
+              "url": "/docs/additional-resources/qiskit-1.0-features"
+            }
+          ]
+        },
+        {
+          "title": "Migrate from Sampler to Executor",
+          "url": "/docs/additional-resources/migrate-from-sampler-to-executor",
+          "isNew": true,
+          "isNewDate": "2026-08-06"
+        },
+        {
+          "title": "Migrate from Qiskit Pulse to fractional gates",
+          "url": "/docs/additional-resources/pulse-migration"
+        },
+        {
+          "title": "Migrate to local simulators",
+          "url": "/docs/additional-resources/local-simulators"
+        }
+      ]
+    },
+    {
+      "title": "Open-source resources",
+      "children": [
+        {
+          "title": "Introduction",
+          "url": "/docs/additional-resources/open-source"
+        },
+        {
+          "title": "Code of conduct",
+          "url": "/docs/additional-resources/code-of-conduct"
+        },
+        {
+          "title": "Contributor license agreements",
+          "children": [
+            {
+              "title": "Individual contributor",
+              "url": "/docs/open-source/qiskit-cla.pdf"
+            },
+            {
+              "title": "Corporate contributor",
+              "url": "/docs/open-source/qiskit-corporate-cla.pdf"
+            }
+          ]
+        },
+        {
+          "title": "Qiskit SDK",
+          "children": [
+            {
+              "title": "Version strategy",
+              "url": "/docs/additional-resources/qiskit-sdk-version-strategy"
+            },
+            {
+              "title": "Contributor guide",
+              "url": "https://github.com/Qiskit/qiskit/blob/main/CONTRIBUTING.md"
+            },
+            {
+              "title": "Maintainer guide",
+              "url": "https://github.com/Qiskit/qiskit/blob/main/MAINTAINING.md"
+            }
+          ]
+        },
+        {
+          "title": "Qiskit ecosystem",
+          "url": "https://www.ibm.com/quantum/ecosystem"
+        }
+      ]
+    },
+    {
+      "title": "Security and compliance",
+      "collapsed": true,
+      "children": [
+        {
+          "title": "Securing your data",
+          "url": "/docs/additional-resources/secure-data"
+        },
+        {
+          "title": "Understanding your responsibilities when using IBM Quantum Compute Service",
+          "url": "/docs/additional-resources/responsibilities"
+        },
+        {
+          "title": "Use virtual private endpoints for VPC",
+          "url": "/docs/additional-resources/virtual-private-endpoints"
+        },
+        {
+          "title": "High availability and disaster recovery",
+          "url": "/docs/additional-resources/ha-dr"
+        },
+        {
+          "title": "Activity tracking events for IBM Quantum Compute Service",
+          "url": "/docs/additional-resources/observability-runtime-rest"
+        },
+        {
+          "title": "Activity tracking events for the IBM Quantum System service",
+          "url": "/docs/additional-resources/observability-quantum-system"
+        },
+        {
+          "title": "Authorization roles",
+          "url": "/docs/additional-resources/authorization-roles"
+        },
+        {
+          "title": "Repository security policies",
+          "url": "/docs/additional-resources/security-policies"
+        },
+        {
+          "title": "Protecting IBM Quantum Compute Service resources with context-based restrictions",
+          "url": "/docs/additional-resources/context-based-restrictions"
+        }
+      ]
+    }
+  ]
+}

docs/additional-resources/index.mdx

@@ -0,0 +1,50 @@
+---
+title: Additional resources
+description: Support, migration guides, open-source resources, and security and compliance information for Qiskit and IBM Quantum.
+---
+
+# Additional resources
+
+This section collects support channels, migration guides, open-source project information, and security and compliance documentation for Qiskit and IBM Quantum.
+
+<CardGroup>
+    <Card
+      title="Support and FAQ"
+      description="Find answers to frequently-asked questions and learn how to get help."
+      href="/docs/additional-resources/support"
+      analyticsName="Additional resources: Support and FAQ"
+      linkText="Get help"
+    />
+
+    <Card
+      title="Development workflow"
+      description="Learn the recommended workflow for developing quantum programs with Qiskit patterns."
+      href="/docs/additional-resources/intro-to-patterns"
+      analyticsName="Additional resources: Development workflow"
+      linkText="View workflow"
+    />
+
+    <Card
+      title="Migration guides"
+      description="Migrate between Qiskit versions and between execution primitives."
+      href="/docs/additional-resources/qiskit-2.0"
+      analyticsName="Additional resources: Migration guides"
+      linkText="View migration guides"
+    />
+
+    <Card
+      title="Open-source resources"
+      description="Learn how to contribute to Qiskit and its ecosystem, and review the code of conduct and contributor license agreements."
+      href="/docs/additional-resources/open-source"
+      analyticsName="Additional resources: Open-source resources"
+      linkText="View resources"
+    />
+
+    <Card
+      title="Security and compliance"
+      description="Review data security, responsibilities, and compliance information for IBM Quantum Compute Service."
+      href="/docs/additional-resources/secure-data"
+      analyticsName="Additional resources: Security and compliance"
+      linkText="View security information"
+    />
+</CardGroup>

docs/api/functions/_toc.json

@@ -6,70 +6,91 @@
             "url": "/docs/api/functions"
         },
         {
-            "title": "Circuit functions",
+            "title": "Optimization",
             "untranslatable": true,
             "children": [
                 {
-                  "title": "Algorithmiq Tensor-network error mitigation",
-                  "url": "/docs/api/functions/algorithmiq-tem",
-                  "untranslatable": true
+                    "title": "Kipu Quantum Iskay Quantum Optimizer",
+                    "url": "/docs/api/functions/kipu-optimization",
+                    "untranslatable": true
                 },
                 {
-                  "title": "Q-CTRL Performance Management",
-                  "url": "/docs/api/functions/q-ctrl-performance-management",
+                  "title": "Q-CTRL Optimization Solver",
+                  "url": "/docs/api/functions/q-ctrl-optimization-solver",
                   "untranslatable": true
                 },
                 {
-                  "title": "Qedma QESEM",
-                  "url": "/docs/api/functions/qedma-qesem",
+                  "title": "Quantum Portfolio Optimizer by Global Data Quantum",
+                  "url": "/docs/api/functions/global-data-quantum-optimizer",
                   "untranslatable": true
-                },
-                {
-                  "title": "Quantum Elements Orbit",
-                  "url": "/docs/api/functions/quantum-elements-orbit",
-                  "untranslatable": true,
-                  "isNew":true,
-                  "isNewDate": "2026-07-22"
                 }
             ],
             "collapsible": false
         },
         {
-            "title": "Application functions",
+            "title": "Machine learning",
             "untranslatable": true,
             "children": [
-                {
-                    "title": "Kipu Quantum Iskay Quantum Optimizer",
-                    "url": "/docs/api/functions/kipu-optimization",
-                    "untranslatable": true
-                },
                 {
                   "title": "Multiverse Computing Singularity",
                   "url": "/docs/api/functions/multiverse-computing-singularity",
                   "untranslatable": true
-                },
+                }
+            ],
+            "collapsible": false
+        },
+        {
+            "title": "Differential equations",
+            "untranslatable": true,
+            "children": [
                 {
-                  "title": "Q-CTRL Optimization Solver",
-                  "url": "/docs/api/functions/q-ctrl-optimization-solver",
+                  "title": "QUICK-PDE: A Qiskit Function by ColibriTD",
+                  "url": "/docs/api/functions/colibritd-pde",
                   "untranslatable": true
-                },
+                }
+            ],
+            "collapsible": false
+        },
+        {
+            "title": "Hamiltonian simulation",
+            "untranslatable": true,
+            "children": [
                 {
-                  "title": "Quantum Portfolio Optimizer by Global Data Quantum",
-                  "url": "/docs/api/functions/global-data-quantum-optimizer",
+                  "title": "Qunova Computing HI-VQE Chemistry",
+                  "url": "/docs/api/functions/qunova-chemistry",
+                  "untranslatable": true
+                }
+            ],
+            "collapsible": false
+        },
+        {
+            "title": "Circuit performance",
+            "untranslatable": true,
+            "children": [
+                {
+                  "title": "Algorithmiq Tensor-network error mitigation",
+                  "url": "/docs/api/functions/algorithmiq-tem",
                   "untranslatable": true
                 },
                 {
-                  "title": "QUICK-PDE: A Qiskit Function by ColibriTD",
-                  "url": "/docs/api/functions/colibritd-pde",
+                  "title": "Q-CTRL Performance Management",
+                  "url": "/docs/api/functions/q-ctrl-performance-management",
                   "untranslatable": true
                 },
                 {
-                  "title": "Qunova Computing HI-VQE Chemistry",
-                  "url": "/docs/api/functions/qunova-chemistry",
+                  "title": "Qedma QESEM",
+                  "url": "/docs/api/functions/qedma-qesem",
                   "untranslatable": true
+                },
+                {
+                  "title": "Quantum Elements Orbit",
+                  "url": "/docs/api/functions/quantum-elements-orbit",
+                  "untranslatable": true,
+                  "isNew":true,
+                  "isNewDate": "2026-07-22"
                 }
             ],
             "collapsible": false
         }
     ]
-}
+}