chore: remove deprecated systems for routing logic

pages/01-overview/01-introduction.md

@@ -10,7 +10,7 @@ Plural is a unified cloud orchestrator for the management of Kubernetes at scale
 
 1. Kubernetes Continuous Deployment - you need a GitOps-based, drift-detecting mechanism to sync kubernetes yaml manifests, written in helm, kustomize, raw yaml, etc, into target kubernetes clusters.  It should also be orchestrable via API to support a scalable workflow to any fleet size.
 2. Kubernetes Dashboarding - A secure, SSO-integrated Kubernetes dashboard layer for ad-hoc troubleshooting.  GitOps should handle anything on a write-path, but you still need a strong read-path that's not burdened with friction.
-3. Infrastructure-As-Code Management - implemented via Stacks, this provides a k8s-native, API-driven mechanism to scalably manage the terraform complexity that immediately arises when using kubernetes in earnest.
+3. Infrastructure-As-Code Management - implemented via {% doclink to="plural_features_stacks_iac_management" %}Stacks{% /doclink %}, this provides a k8s-native, API-driven mechanism to scalably manage the terraform complexity that immediately arises when using kubernetes in earnest.
 4. Self-Service Code Generation - the glue that ties everything together, a repeatable PR Automation API that allows you to self-serviceably generate the manifests for any workflow in 1-3 with a simple UI wizard.  Think of it like Backstage for Kubernetes.
 
 In addition, we support a robust, enterprise-ready {% doclink to="overview_architecture" %}Architecture{% /doclink %}. This uses a separation of management cluster and an agent w/in each workload cluster to achieve scalability and enhanced security to compensate for the risks caused by introducing a Single-Pane-of-Glass to Kubernetes.  The agent can only communicate to the management cluster via egress networking, and executes all write operations with local credentials, removing the need for the management cluster to be a repository of global credentials.  If you want to learn more about the nuts-and-bolts feel free to visit our {% doclink to="overview_architecture" %}Architecture Page{% /doclink %}.

src/routes/docs.generated.ts

@@ -10,378 +10,324 @@ export const docRoutes: DocRouteMap = {
     path: '/01-overview/01-introduction',
     title: 'Introduction',
     id: 'overview_introduction',
-    section: 'overview',
   },
 
   overview_architecture: {
     path: '/01-overview/02-architecture',
     title: 'Architecture',
     id: 'overview_architecture',
-    section: 'overview',
   },
 
   overview_api_reference: {
     path: '/01-overview/03-api-reference',
     title: 'API Reference',
     id: 'overview_api_reference',
-    section: 'overview',
   },
 
   getting_started_first_steps: {
     path: '/02-getting-started/01-first-steps',
     title: 'First steps',
     id: 'getting_started_first_steps',
-    section: 'getting-started',
   },
 
   getting_started_first_steps_cli_quickstart: {
     path: '/02-getting-started/01-first-steps/01-cli-quickstart',
     title: 'Quickstart with the Plural CLI',
     id: 'getting_started_first_steps_cli_quickstart',
-    section: 'getting-started',
   },
 
   getting_started_first_steps_existing_cluster: {
     path: '/02-getting-started/01-first-steps/02-existing-cluster',
     title: 'Bring your own K8s cluster',
     id: 'getting_started_first_steps_existing_cluster',
-    section: 'getting-started',
   },
 
   getting_started_how_to_use: {
     path: '/02-getting-started/02-how-to-use',
     title: 'How to use Plural',
     id: 'getting_started_how_to_use',
-    section: 'getting-started',
   },
 
   getting_started_how_to_use_mgmt_cluster: {
     path: '/02-getting-started/02-how-to-use/01-mgmt-cluster',
     title: 'Provision a management cluster',
     id: 'getting_started_how_to_use_mgmt_cluster',
-    section: 'getting-started',
   },
 
   getting_started_how_to_use_rbac: {
     path: '/02-getting-started/02-how-to-use/02-rbac',
     title: 'Add RBAC to the K8s dashboard',
     id: 'getting_started_how_to_use_rbac',
-    section: 'getting-started',
   },
 
   getting_started_how_to_use_scm_connection: {
     path: '/02-getting-started/02-how-to-use/03-scm-connection',
     title: 'Connect a source control provider',
     id: 'getting_started_how_to_use_scm_connection',
-    section: 'getting-started',
   },
 
   getting_started_how_to_use_workload_cluster: {
     path: '/02-getting-started/02-how-to-use/04-workload-cluster',
     title: 'Provision a workload cluster',
     id: 'getting_started_how_to_use_workload_cluster',
-    section: 'getting-started',
   },
 
   getting_started_how_to_use_controllers: {
     path: '/02-getting-started/02-how-to-use/05-controllers',
     title: 'Set up ingress on a cluster',
     id: 'getting_started_how_to_use_controllers',
-    section: 'getting-started',
   },
 
   getting_started_how_to_use_pr_automation: {
     path: '/02-getting-started/02-how-to-use/06-pr-automation',
     title: 'Use PR automations for self-service',
     id: 'getting_started_how_to_use_pr_automation',
-    section: 'getting-started',
   },
 
   getting_started_how_to_use_microservice: {
     path: '/02-getting-started/02-how-to-use/07-microservice',
     title: 'Deploy the first microservice',
     id: 'getting_started_how_to_use_microservice',
-    section: 'getting-started',
   },
 
   getting_started_how_to_use_pipelines: {
     path: '/02-getting-started/02-how-to-use/08-pipelines',
     title: 'Setup a dev -> prod pipeline',
     id: 'getting_started_how_to_use_pipelines',
-    section: 'getting-started',
   },
 
   getting_started_advanced_config: {
     path: '/02-getting-started/03-advanced-config',
     title: 'Advanced configuration',
     id: 'getting_started_advanced_config',
-    section: 'getting-started',
   },
 
   getting_started_advanced_config_sandboxing: {
     path: '/02-getting-started/03-advanced-config/01-sandboxing',
     title: 'Sandboxing your cluster',
     id: 'getting_started_advanced_config_sandboxing',
-    section: 'getting-started',
   },
 
   getting_started_advanced_config_network_configuration: {
     path: '/02-getting-started/03-advanced-config/02-network-configuration',
     title: 'Network configuration',
     id: 'getting_started_advanced_config_network_configuration',
-    section: 'getting-started',
   },
 
   getting_started_advanced_config_private_ca: {
     path: '/02-getting-started/03-advanced-config/03-private-ca',
     title: 'Handling private CAs',
     id: 'getting_started_advanced_config_private_ca',
-    section: 'getting-started',
   },
 
   plural_features_continuous_deployment: {
     path: '/03-plural-features/01-continuous-deployment',
     title: 'Continuous deployment',
     id: 'plural_features_continuous_deployment',
-    section: 'plural-features',
   },
 
   plural_features_continuous_deployment_deployment_operator: {
     path: '/03-plural-features/01-continuous-deployment/01-deployment-operator',
     title: 'The deployment operator',
     id: 'plural_features_continuous_deployment_deployment_operator',
-    section: 'plural-features',
   },
 
   plural_features_continuous_deployment_git_service: {
     path: '/03-plural-features/01-continuous-deployment/02-git-service',
     title: 'Git-sourced services',
     id: 'plural_features_continuous_deployment_git_service',
-    section: 'plural-features',
   },
 
   plural_features_continuous_deployment_helm_service: {
     path: '/03-plural-features/01-continuous-deployment/03-helm-service',
     title: 'Helm-sourced services',
     id: 'plural_features_continuous_deployment_helm_service',
-    section: 'plural-features',
   },
 
   plural_features_continuous_deployment_global_service: {
     path: '/03-plural-features/01-continuous-deployment/04-global-service',
     title: 'Global services',
     id: 'plural_features_continuous_deployment_global_service',
-    section: 'plural-features',
   },
 
   plural_features_k8s_upgrade_assistant: {
     path: '/03-plural-features/02-k8s-upgrade-assistant',
     title: 'Plural upgrade assistant',
     id: 'plural_features_k8s_upgrade_assistant',
-    section: 'plural-features',
   },
 
   plural_features_stacks_iac_management: {
     path: '/03-plural-features/03-stacks-iac-management',
     title: 'Stacks — IaC management',
     id: 'plural_features_stacks_iac_management',
-    section: 'plural-features',
   },
 
   plural_features_stacks_iac_management_customize_runners: {
     path: '/03-plural-features/03-stacks-iac-management/01-customize-runners',
     title: 'Customize stack runners',
     id: 'plural_features_stacks_iac_management_customize_runners',
-    section: 'plural-features',
   },
 
   plural_features_stacks_iac_management_pr_workflow: {
     path: '/03-plural-features/03-stacks-iac-management/02-pr-workflow',
     title: 'Stack PR workflow',
     id: 'plural_features_stacks_iac_management_pr_workflow',
-    section: 'plural-features',
   },
 
   plural_features_stacks_iac_management_manual_runs: {
     path: '/03-plural-features/03-stacks-iac-management/03-manual-runs',
     title: 'Manual runs',
     id: 'plural_features_stacks_iac_management_manual_runs',
-    section: 'plural-features',
   },
 
   plural_features_stacks_iac_management_local_execution: {
     path: '/03-plural-features/03-stacks-iac-management/04-local-execution',
     title: 'Local execution',
     id: 'plural_features_stacks_iac_management_local_execution',
-    section: 'plural-features',
   },
 
   plural_features_stacks_iac_management_custom_stacks: {
     path: '/03-plural-features/03-stacks-iac-management/05-custom-stacks',
     title: 'Custom stacks',
     id: 'plural_features_stacks_iac_management_custom_stacks',
-    section: 'plural-features',
   },
 
   plural_features_stacks_iac_management_auto_cancellation: {
     path: '/03-plural-features/03-stacks-iac-management/06-auto-cancellation',
     title: 'Auto cancellation',
     id: 'plural_features_stacks_iac_management_auto_cancellation',
-    section: 'plural-features',
   },
 
   plural_features_stacks_iac_management_service_contexts: {
     path: '/03-plural-features/03-stacks-iac-management/07-service-contexts',
     title: 'Terraform interop with service contexts',
     id: 'plural_features_stacks_iac_management_service_contexts',
-    section: 'plural-features',
   },
 
   plural_features_service_catalog: {
     path: '/03-plural-features/04-service-catalog',
     title: 'Service catalog',
     id: 'plural_features_service_catalog',
-    section: 'plural-features',
   },
 
   plural_features_service_catalog_creation: {
     path: '/03-plural-features/04-service-catalog/01-creation',
     title: 'Creating your own catalog',
     id: 'plural_features_service_catalog_creation',
-    section: 'plural-features',
   },
 
   plural_features_service_catalog_contribution_program: {
     path: '/03-plural-features/04-service-catalog/02-contribution-program',
     title: 'Contribution program',
     id: 'plural_features_service_catalog_contribution_program',
-    section: 'plural-features',
   },
 
   plural_features_kubernetes_dashboard: {
     path: '/03-plural-features/05-kubernetes-dashboard',
     title: 'Kubernetes dashboard',
     id: 'plural_features_kubernetes_dashboard',
-    section: 'plural-features',
   },
 
   plural_features_plural_ai: {
     path: '/03-plural-features/06-plural-ai',
     title: 'Plural AI helper',
     id: 'plural_features_plural_ai',
-    section: 'plural-features',
   },
 
   plural_features_plural_ai_setup: {
     path: '/03-plural-features/06-plural-ai/01-setup',
     title: 'Setup Plural AI',
     id: 'plural_features_plural_ai_setup',
-    section: 'plural-features',
   },
 
   plural_features_plural_ai_architecture: {
     path: '/03-plural-features/06-plural-ai/02-architecture',
     title: 'Plural AI Architecture',
     id: 'plural_features_plural_ai_architecture',
-    section: 'plural-features',
   },
 
   plural_features_plural_ai_cost: {
     path: '/03-plural-features/06-plural-ai/03-cost',
     title: 'Plural AI cost analysis',
     id: 'plural_features_plural_ai_cost',
-    section: 'plural-features',
   },
 
   plural_features_pr_automation: {
     path: '/03-plural-features/07-pr-automation',
     title: 'Pull request automation',
     id: 'plural_features_pr_automation',
-    section: 'plural-features',
   },
 
   plural_features_pr_automation_crds: {
     path: '/03-plural-features/07-pr-automation/01-crds',
     title: 'PR automation custom resources',
     id: 'plural_features_pr_automation_crds',
-    section: 'plural-features',
   },
 
   plural_features_pr_automation_testing: {
     path: '/03-plural-features/07-pr-automation/02-testing',
     title: 'PR automation testing',
     id: 'plural_features_pr_automation_testing',
-    section: 'plural-features',
   },
 
   plural_features_pr_automation_pipelines: {
     path: '/03-plural-features/07-pr-automation/03-pipelines',
     title: 'PR automation pipelines',
     id: 'plural_features_pr_automation_pipelines',
-    section: 'plural-features',
   },
 
   plural_features_service_templating: {
     path: '/03-plural-features/08-service-templating',
     title: 'Service templating',
     id: 'plural_features_service_templating',
-    section: 'plural-features',
   },
 
   plural_features_service_templating_templating_filters: {
     path: '/03-plural-features/08-service-templating/01-templating-filters',
     title: 'Supporting liquid filters',
     id: 'plural_features_service_templating_templating_filters',
-    section: 'plural-features',
   },
 
   plural_features_projects_and_multi_tenancy: {
     path: '/03-plural-features/09-projects-and-multi-tenancy',
     title: 'Projects and multi-tenancy',
     id: 'plural_features_projects_and_multi_tenancy',
-    section: 'plural-features',
   },
 
   plural_features_notifications: {
     path: '/03-plural-features/10-notifications',
     title: 'Notification configuration',
     id: 'plural_features_notifications',
-    section: 'plural-features',
   },
 
   faq_security: {
     path: '/04-faq/01-security',
     title: 'Is Plural secure?',
     id: 'faq_security',
-    section: 'faq',
   },
 
   faq_plural_oidc: {
     path: '/04-faq/02-plural-oidc',
     title: 'Does Plural support OpenID Connect?',
     id: 'faq_plural_oidc',
-    section: 'faq',
   },
 
   faq_certifications: {
     path: '/04-faq/03-certifications',
     title: 'What certifications does Plural have?',
     id: 'faq_certifications',
-    section: 'faq',
   },
 
   faq_paid_tiers: {
     path: '/04-faq/04-paid-tiers',
     title: 'How do Plural paid tiers work?',
     id: 'faq_paid_tiers',
-    section: 'faq',
   },
 
   resources_release_notes: {
     path: '/05-resources/01-release-notes',
     title: 'Release Notes',
     id: 'resources_release_notes',
-    section: 'resources',
   },
 } as const
 
@@ -395,11 +341,6 @@ export function getRouteById(id: string): DocRoute | undefined {
   return Object.values(docRoutes).find((route) => route.id === id)
 }
 
-// Get all routes in a section
-export function getRoutesBySection(section: string): DocRoute[] {
-  return Object.values(docRoutes).filter((route) => route.section === section)
-}
-
 // Get route by path (including redirects)
 export function getRouteByPath(path: string): DocRoute | undefined {
   // First try direct path match