sidebars.ts

import type { SidebarsConfig } from '@docusaurus/plugin-content-docs';

// Helper function for section dividers
const sectionDivider = (label: string) => ({
  type: 'html' as const,
  value: `<br/><strong>${label}</strong>`,
  defaultStyle: true,
});

// Product-specific sections
const platform = {
  practitioner: {
    type: 'category' as const,
    label: 'Platform',
    customProps: {
      gemIcon: 'clear-block',
      megaMenu: true,
      homepageHref: '/user-documentation/moderne-platform/getting-started/running-your-first-recipe',
    },
    link: {
      type: 'generated-index' as const,
      title: 'Moderne Platform',
      description: 'A secure platform and toolchain for fast, enterprise-wide code modernization.',
      slug: '/user-documentation/moderne-platform',
      keywords: ['guides'],
    },
    items: [
      {
        type: 'category' as const,
        label: 'Getting started',
        link: {
          type: 'generated-index' as const,
          title: 'Getting started',
          description: 'Learn how to get started with the Moderne Platform.',
          slug: '/user-documentation/moderne-platform/getting-started',
          keywords: ['guides'],
        },
        items: [
          'user-documentation/moderne-platform/getting-started/running-your-first-recipe',
          'user-documentation/moderne-platform/getting-started/proof-of-value-prerequisites',
          'user-documentation/moderne-platform/getting-started/proof-of-value',
          'user-documentation/moderne-platform/getting-started/proof-of-value-csharp',
          'user-documentation/moderne-platform/getting-started/code-quality',
          'user-documentation/moderne-platform/getting-started/data-tables',
          'user-documentation/moderne-platform/getting-started/visualizations',
          'user-documentation/moderne-platform/getting-started/dev-center',
          'user-documentation/moderne-platform/getting-started/changelog',
          'user-documentation/moderne-platform/getting-started/prethink',
          'user-documentation/moderne-platform/getting-started/activity-view',
        ],
      },
      {
        type: 'category' as const,
        label: 'How to guides',
        link: {
          type: 'generated-index' as const,
          title: 'How to guides',
          description: 'Learn how to work with the Moderne Platform.',
          slug: '/user-documentation/moderne-platform/how-to-guides',
          keywords: ['guides'],
        },
        items: [
          'user-documentation/moderne-platform/how-to-guides/vulnerability-remediation-playbook',
          'user-documentation/moderne-platform/how-to-guides/find-pii',
          'user-documentation/moderne-platform/how-to-guides/vulnerable-dependencies',
          'user-documentation/moderne-platform/how-to-guides/addressing-cves',
          'user-documentation/moderne-platform/how-to-guides/new-recipe-builder',
          'user-documentation/moderne-platform/how-to-guides/introduction-to-type-aware-code-search',
          'user-documentation/moderne-platform/how-to-guides/moderne-platform-search',
          'user-documentation/moderne-platform/how-to-guides/accessing-the-moderne-api',
          'user-documentation/moderne-platform/how-to-guides/recipe-execution-and-commits-with-graphql',
          'user-documentation/moderne-platform/how-to-guides/managing-user-configured-organizations',
          'user-documentation/moderne-platform/how-to-guides/create-api-access-tokens',
          'user-documentation/moderne-platform/how-to-guides/preconditions',
          'user-documentation/moderne-platform/how-to-guides/track-migrations',
          'user-documentation/moderne-platform/how-to-guides/track-commits',
          'user-documentation/moderne-platform/how-to-guides/transitive-dependencies',
          'user-documentation/moderne-platform/how-to-guides/writing-and-installing-recipes',
        ],
      },
      {
        type: 'category' as const,
        label: 'References',
        link: {
          type: 'generated-index' as const,
          title: 'References',
          description: 'Moderne Platform reference documentation.',
          slug: '/user-documentation/moderne-platform/references',
          keywords: ['references'],
        },
        items: [
          'user-documentation/moderne-platform/references/moderne-tokens',
          'user-documentation/moderne-platform/references/create-scm-access-tokens',
          'user-documentation/moderne-platform/references/graphql-api-reference',
        ],
      },
    ],
  },

  admin: {
    type: 'category' as const,
    label: 'Platform',
    customProps: {},
    link: {
      type: 'generated-index' as const,
      title: 'Moderne Platform',
      description: 'Moderne Platform administrator documentation. Includes information on configuring and setting up the Moderne Connector among other things.',
      slug: '/administrator-documentation/moderne-platform',
      keywords: ['guides'],
    },
    items: [
      {
        type: 'category' as const,
        label: 'Getting started',
        link: {
          type: 'generated-index' as const,
          title: 'Getting started',
          description: 'Learn how to get started with the Moderne Platform as an administrator.',
          slug: '/administrator-documentation/moderne-platform/getting-started',
          keywords: ['guides'],
        },
        items: [
          'administrator-documentation/moderne-platform/getting-started/admin-pages',
        ],
      },
      {
        type: 'category' as const,
        label: 'How to guides',
        link: {
          type: 'generated-index' as const,
          title: 'How to guides',
          description: 'Administrator setup and configuration documentation.',
          slug: '/administrator-documentation/moderne-platform/how-to-guides',
          keywords: ['guides'],
        },
        items: [
          'administrator-documentation/moderne-platform/how-to-guides/mass-ingest',
          {
            type: 'category' as const,
            label: 'Configuring telemetry exports',
            link: {
              type: 'generated-index' as const,
              title: 'Configuring telemetry exports',
              description: 'Receive Moderne CLI and SaaS telemetry into your own cloud account and build BI reports on top of it.',
              slug: '/administrator-documentation/moderne-platform/configuring-telemetry-exports',
              keywords: ['guides'],
            },
            items: [
              'administrator-documentation/moderne-platform/how-to-guides/configuring-telemetry-exports/overview',
              'administrator-documentation/moderne-platform/how-to-guides/configuring-telemetry-exports/aws-replication',
              'administrator-documentation/moderne-platform/how-to-guides/configuring-telemetry-exports/azure-replication',
              'administrator-documentation/moderne-platform/how-to-guides/configuring-telemetry-exports/querying-and-bi',
            ],
          },
          {
            type: 'category' as const,
            label: 'Moderne Connector',
            link: {
              type: 'generated-index' as const,
              title: 'Moderne Connector',
              description: 'Moderne Connector configuration documentation.',
              slug: '/administrator-documentation/moderne-platform/connector-configuration',
              keywords: ['guides'],
            },
            items: [
              'administrator-documentation/moderne-platform/how-to-guides/connector-configuration/connector-config',
              'administrator-documentation/moderne-platform/how-to-guides/connector-configuration/configure-a-connector-with-azure-devops-services',
              'administrator-documentation/moderne-platform/how-to-guides/connector-configuration/configure-bitbucket-to-connector',
              'administrator-documentation/moderne-platform/how-to-guides/connector-configuration/configure-bitbucket-cloud-to-connector',
              'administrator-documentation/moderne-platform/how-to-guides/connector-configuration/configure-a-connector-with-github',
              'administrator-documentation/moderne-platform/how-to-guides/connector-configuration/configure-a-connector-with-gitlab',
              'administrator-documentation/moderne-platform/how-to-guides/connector-configuration/configure-a-connector-with-maven-repository-access',
              'administrator-documentation/moderne-platform/how-to-guides/connector-configuration/configure-a-connector-with-artifactory-access',
              'administrator-documentation/moderne-platform/how-to-guides/connector-configuration/configure-recipe-marketplace-repositories',
              'administrator-documentation/moderne-platform/how-to-guides/connector-configuration/configure-a-connector-with-s3-access',
              'administrator-documentation/moderne-platform/how-to-guides/connector-configuration/configure-a-connector-with-pypi-access-visualizations',
              'administrator-documentation/moderne-platform/how-to-guides/connector-configuration/configure-a-connector-with-llm-for-moddy',
              'administrator-documentation/moderne-platform/how-to-guides/connector-configuration/configure-organizations-hierarchy',
              'administrator-documentation/moderne-platform/how-to-guides/connector-configuration/configure-a-connector-with-generic-http-tools-for-use-in-recipes',
              'administrator-documentation/moderne-platform/how-to-guides/connector-configuration/configure-a-connector-with-strict-recipe-sources',
              'administrator-documentation/moderne-platform/how-to-guides/connector-configuration/configure-a-connector-with-client-ssl-certificates',
              'administrator-documentation/moderne-platform/how-to-guides/connector-configuration/configure-a-connector-with-a-moderne-tenant-ssl-certificate',
              'administrator-documentation/moderne-platform/how-to-guides/connector-configuration/configure-a-connector-to-connect-to-moderne-via-an-http-proxy',
              'administrator-documentation/moderne-platform/how-to-guides/connector-configuration/configure-a-connector-with-cli-download-instructions-override',
              'administrator-documentation/moderne-platform/how-to-guides/connector-configuration/configure-a-connector-with-ui-customizations',
              'administrator-documentation/moderne-platform/how-to-guides/connector-configuration/connector-variables',
            ],
          },
          'administrator-documentation/moderne-platform/how-to-guides/creating-a-devcenter-recipe',
          'administrator-documentation/moderne-platform/how-to-guides/recipe-based-devcenter',
          'administrator-documentation/moderne-platform/how-to-guides/org-service',
          'administrator-documentation/moderne-platform/how-to-guides/create-visualization',
          'administrator-documentation/moderne-platform/how-to-guides/importing-external-recipes',
          'administrator-documentation/moderne-platform/how-to-guides/categorize-recipes',
          'administrator-documentation/moderne-platform/how-to-guides/lst-cleanup',
          'administrator-documentation/moderne-platform/how-to-guides/troubleshooting-lst-issues',
          'administrator-documentation/moderne-platform/how-to-guides/analyzing-build-failures',
        ],
      },
      {
        type: 'category' as const,
        label: 'References',
        link: {
          type: 'generated-index' as const,
          title: 'References',
          description: 'Administrator reference documentation for the Moderne Platform.',
          slug: '/administrator-documentation/moderne-platform/references',
          keywords: ['reference'],
        },
        items: [
          'administrator-documentation/moderne-platform/references/authentication',
          'administrator-documentation/moderne-platform/references/audit-logging',
          'administrator-documentation/moderne-platform/references/architecture',
          'administrator-documentation/moderne-platform/references/ai-architecture',
          'administrator-documentation/moderne-platform/references/flow',
          'administrator-documentation/moderne-platform/references/user-roles',
          'administrator-documentation/moderne-platform/references/github-permissions',
          'administrator-documentation/moderne-platform/references/how-moderne-applies-changes',
          'administrator-documentation/moderne-platform/references/routing-requests-to-agents',
          'administrator-documentation/moderne-platform/references/how-lst-artifacts-are-produced',
          'administrator-documentation/moderne-platform/references/mass-ingest-vs-ci',
          'administrator-documentation/moderne-platform/references/supported-scms',
          'administrator-documentation/moderne-platform/references/standard-vs-enterprise-edition',
          {
            type: 'link' as const,
            label: 'GraphQL API reference',
            description: 'A link to the Moderne GraphQL API reference docs.',
            href: 'https://studio.apollographql.com/public/Moderne-SaaS-API/variant/current',
          },
        ],
      },
      'administrator-documentation/moderne-platform/faq',
    ],
  },
};

const platformV1 = {
  practitioner: {
    type: 'category' as const,
    label: 'Platform (SaaS v1)',
    customProps: {},
    link: {
      type: 'generated-index' as const,
      title: 'Moderne Platform (SaaS v1)',
      description: 'A secure platform and toolchain for fast, enterprise-wide code modernization.',
      slug: '/user-documentation/moderne-platform-v1',
      keywords: ['guides'],
    },
    items: [
      {
        type: 'category' as const,
        label: 'Getting started',
        link: {
          type: 'generated-index' as const,
          title: 'Getting started',
          description: 'Learn how to get started with the Moderne Platform.',
          slug: '/user-documentation/moderne-platform-v1/getting-started',
          keywords: ['guides'],
        },
        items: [
          'user-documentation/moderne-platform-v1/getting-started/running-your-first-recipe',
          'user-documentation/moderne-platform-v1/getting-started/proof-of-value-prerequisites',
          'user-documentation/moderne-platform-v1/getting-started/proof-of-value',
          'user-documentation/moderne-platform-v1/getting-started/code-quality',
          'user-documentation/moderne-platform-v1/getting-started/data-tables',
          'user-documentation/moderne-platform-v1/getting-started/visualizations',
          'user-documentation/moderne-platform-v1/getting-started/dev-center',
          'user-documentation/moderne-platform-v1/getting-started/prethink',
          'user-documentation/moderne-platform-v1/getting-started/activity-view',
        ],
      },
      {
        type: 'category' as const,
        label: 'How to guides',
        link: {
          type: 'generated-index' as const,
          title: 'How to guides',
          description: 'Learn how to work with the Moderne Platform.',
          slug: '/user-documentation/moderne-platform-v1/how-to-guides',
          keywords: ['guides'],
        },
        items: [
          'user-documentation/moderne-platform-v1/how-to-guides/find-pii',
          'user-documentation/moderne-platform-v1/how-to-guides/vulnerable-dependencies',
          'user-documentation/moderne-platform-v1/how-to-guides/addressing-cves',
          'user-documentation/moderne-platform-v1/how-to-guides/new-recipe-builder',
          'user-documentation/moderne-platform-v1/how-to-guides/introduction-to-type-aware-code-search',
          'user-documentation/moderne-platform-v1/how-to-guides/moderne-platform-search',
          'user-documentation/moderne-platform-v1/how-to-guides/accessing-the-moderne-api',
          'user-documentation/moderne-platform-v1/how-to-guides/recipe-execution-and-commits-with-graphql',
          'user-documentation/moderne-platform-v1/how-to-guides/managing-user-configured-organizations',
          'user-documentation/moderne-platform-v1/how-to-guides/create-api-access-tokens',
          'user-documentation/moderne-platform-v1/how-to-guides/preconditions',
          'user-documentation/moderne-platform-v1/how-to-guides/track-migrations',
          'user-documentation/moderne-platform-v1/how-to-guides/track-commits',
          'user-documentation/moderne-platform-v1/how-to-guides/transitive-dependencies',
          'user-documentation/moderne-platform-v1/how-to-guides/writing-and-installing-recipes',
          'user-documentation/moderne-platform-v1/how-to-guides/categorize-recipes',
        ],
      },
      {
        type: 'category' as const,
        label: 'References',
        link: {
          type: 'generated-index' as const,
          title: 'References',
          description: 'Moderne Platform reference documentation.',
          slug: '/user-documentation/moderne-platform-v1/references',
          keywords: ['references'],
        },
        items: [
          'user-documentation/moderne-platform-v1/references/moderne-tokens',
          'user-documentation/moderne-platform-v1/references/create-scm-access-tokens',
        ],
      },
    ],
  },

  admin: {
    type: 'category' as const,
    label: 'Platform (SaaS v1)',
    customProps: {},
    link: {
      type: 'generated-index' as const,
      title: 'Moderne Platform (SaaS v1)',
      description: 'Moderne Platform administrator documentation. Includes information on configuring and setting up the Moderne Agent among other things.',
      slug: '/administrator-documentation/moderne-platform-v1',
      keywords: ['guides'],
    },
    items: [
      {
        type: 'category' as const,
        label: 'Getting started',
        link: {
          type: 'generated-index' as const,
          title: 'Getting started',
          description: 'Learn how to get started with the Moderne Platform as an administrator.',
          slug: '/administrator-documentation/moderne-platform-v1/getting-started',
          keywords: ['guides'],
        },
        items: [
          'administrator-documentation/moderne-platform-v1/getting-started/admin-pages',
        ],
      },
      {
        type: 'category' as const,
        label: 'How to guides',
        link: {
          type: 'generated-index' as const,
          title: 'How to guides',
          description: 'Administrator setup and configuration documentation.',
          slug: '/administrator-documentation/moderne-platform-v1/how-to-guides',
          keywords: ['guides'],
        },
        items: [
          'administrator-documentation/moderne-platform-v1/how-to-guides/mass-ingest',
          {
            type: 'category' as const,
            label: 'Moderne Agent',
            link: {
              type: 'generated-index' as const,
              title: 'Moderne Agent',
              description: 'Moderne Agent configuration documentation.',
              slug: '/administrator-documentation/moderne-platform-v1/agent-configuration',
              keywords: ['guides'],
            },
            items: [
              'administrator-documentation/moderne-platform-v1/how-to-guides/agent-configuration/agent-config',
              'administrator-documentation/moderne-platform-v1/how-to-guides/agent-configuration/configure-an-agent-with-azure-devops-services',
              'administrator-documentation/moderne-platform-v1/how-to-guides/agent-configuration/configure-bitbucket-to-agent',
              'administrator-documentation/moderne-platform-v1/how-to-guides/agent-configuration/configure-bitbucket-cloud-to-agent',
              'administrator-documentation/moderne-platform-v1/how-to-guides/agent-configuration/configure-an-agent-with-github',
              'administrator-documentation/moderne-platform-v1/how-to-guides/agent-configuration/configure-an-agent-with-gitlab',
              'administrator-documentation/moderne-platform-v1/how-to-guides/agent-configuration/configure-an-agent-with-maven-repository-access',
              'administrator-documentation/moderne-platform-v1/how-to-guides/agent-configuration/configure-an-agent-with-artifactory-access',
              'administrator-documentation/moderne-platform-v1/how-to-guides/agent-configuration/configuring-artifactory-with-recipes',
              'administrator-documentation/moderne-platform-v1/how-to-guides/agent-configuration/configure-an-agent-with-s3-access',
              'administrator-documentation/moderne-platform-v1/how-to-guides/agent-configuration/configure-an-agent-with-pypi-access-visualizations',
              'administrator-documentation/moderne-platform-v1/how-to-guides/agent-configuration/configure-an-agent-with-llm-for-moddy',
              'administrator-documentation/moderne-platform-v1/how-to-guides/agent-configuration/configure-organizations-hierarchy',
              'administrator-documentation/moderne-platform-v1/how-to-guides/agent-configuration/configure-an-agent-with-generic-http-tools-for-use-in-recipes',
              'administrator-documentation/moderne-platform-v1/how-to-guides/agent-configuration/configure-an-agent-with-strict-recipe-sources',
              'administrator-documentation/moderne-platform-v1/how-to-guides/agent-configuration/configure-an-agent-with-client-ssl-certificates',
              'administrator-documentation/moderne-platform-v1/how-to-guides/agent-configuration/configure-an-agent-with-a-moderne-tenant-ssl-certificate',
              'administrator-documentation/moderne-platform-v1/how-to-guides/agent-configuration/configure-an-agent-to-connect-to-moderne-via-an-http-proxy',
              'administrator-documentation/moderne-platform-v1/how-to-guides/agent-configuration/configure-an-agent-with-cli-download-instructions-override',
              'administrator-documentation/moderne-platform-v1/how-to-guides/agent-configuration/configure-an-agent-with-ui-customizations',
              'administrator-documentation/moderne-platform-v1/how-to-guides/agent-configuration/agent-variables',
              'administrator-documentation/moderne-platform-v1/how-to-guides/agent-configuration/multi-tenant-private-recipes',
            ],
          },
          'administrator-documentation/moderne-platform-v1/how-to-guides/creating-a-devcenter-recipe',
          'administrator-documentation/moderne-platform-v1/how-to-guides/recipe-based-devcenter',
          'administrator-documentation/moderne-platform-v1/how-to-guides/org-service',
          'administrator-documentation/moderne-platform-v1/how-to-guides/create-visualization',
          'administrator-documentation/moderne-platform-v1/how-to-guides/importing-external-recipes',
          'administrator-documentation/moderne-platform-v1/how-to-guides/lst-cleanup',
          'administrator-documentation/moderne-platform-v1/how-to-guides/troubleshooting-lst-issues',
          'administrator-documentation/moderne-platform-v1/how-to-guides/analyzing-build-failures',
        ],
      },
      {
        type: 'category' as const,
        label: 'References',
        link: {
          type: 'generated-index' as const,
          title: 'References',
          description: 'Administrator reference documentation for the Moderne Platform.',
          slug: '/administrator-documentation/moderne-platform-v1/references',
          keywords: ['reference'],
        },
        items: [
          'administrator-documentation/moderne-platform-v1/references/authentication',
          'administrator-documentation/moderne-platform-v1/references/reporting',
          'administrator-documentation/moderne-platform-v1/references/audit-logging',
          'administrator-documentation/moderne-platform-v1/references/architecture',
          'administrator-documentation/moderne-platform-v1/references/ai-architecture',
          'administrator-documentation/moderne-platform-v1/references/flow',
          'administrator-documentation/moderne-platform-v1/references/user-roles',
          'administrator-documentation/moderne-platform-v1/references/github-permissions',
          'administrator-documentation/moderne-platform-v1/references/how-moderne-applies-changes',
          'administrator-documentation/moderne-platform-v1/references/routing-requests-to-agents',
          'administrator-documentation/moderne-platform-v1/references/how-lst-artifacts-are-produced',
          'administrator-documentation/moderne-platform-v1/references/supported-scms',
          'administrator-documentation/moderne-platform-v1/references/standard-vs-enterprise-edition',
          'administrator-documentation/moderne-platform-v1/references/lossless-semantic-trees',
          {
            type: 'link' as const,
            label: 'GraphQL API reference',
            description: 'A link to the Moderne GraphQL API reference docs.',
            href: 'https://studio.apollographql.com/public/Moderne-SaaS-API/variant/current',
          },
        ],
      },
      'administrator-documentation/moderne-platform-v1/faq',
    ],
  },
};

const dx = {
  type: 'category' as const,
  label: 'DX',
  customProps: {
    gemIcon: 'red-triangle',
    megaMenu: true,
    homepageHref: '/administrator-documentation/moderne-dx/getting-started/overview',
  },
  link: {
    type: 'generated-index' as const,
    title: 'Moderne DX',
    description: 'Air-gapped, on-prem unified refactoring CLI/IDE solution with recipes & reporting.',
    slug: '/administrator-documentation/moderne-DX',
    keywords: ['guides'],
  },
  items: [
    {
      type: 'category' as const,
      label: 'Getting started',
      link: {
        type: 'generated-index' as const,
        title: 'Getting started',
        description: 'Learn how to get started with Moderne DX as an administrator.',
        slug: '/administrator-documentation/moderne-dx/getting-started',
        keywords: ['guides'],
      },
      items: [
        'administrator-documentation/moderne-dx/getting-started/overview',
        'administrator-documentation/moderne-dx/getting-started/proof-of-value-prerequisites',
      ],
    },
    {
      type: 'category' as const,
      label: 'How to guides',
      link: {
        type: 'generated-index' as const,
        title: 'How to guides',
        description: 'How to configure and use Moderne DX.',
        slug: '/administrator-documentation/moderne-dx/how-to-guides',
        keywords: ['guides'],
      },
      items: [
        'administrator-documentation/moderne-dx/how-to-guides/mass-ingest-dx',
        'administrator-documentation/moderne-dx/how-to-guides/mass-run-dx',
        'administrator-documentation/moderne-dx/how-to-guides/configure-telemetry-dx',
      ],
    },
    {
      type: 'category' as const,
      label: 'References',
      link: {
        type: 'generated-index' as const,
        title: 'References',
        description: 'Moderne DX reference docs.',
        slug: '/administrator-documentation/moderne-dx/references',
        keywords: ['reference'],
      },
      items: [
        'administrator-documentation/moderne-dx/references/moderne-dx-architecture',
      ],
    },
  ],
};

const cli = {
  type: 'category' as const,
  label: 'CLI',
  customProps: {
    gemIcon: 'blue-block',
    megaMenu: true,
    homepageHref: '/user-documentation/moderne-cli/getting-started/cli-intro',
  },
  link: {
    type: 'generated-index' as const,
    title: 'Moderne CLI',
    description: 'A local, Git-like CLI for multi-repo code analysis and automated refactoring at scale.',
    slug: '/user-documentation/moderne-cli',
    keywords: ['guides'],
  },
  items: [
    {
      type: 'category' as const,
      label: 'Getting started',
      link: {
        type: 'generated-index' as const,
        title: 'Getting started',
        description: 'Learn how to get started with the Moderne CLI.',
        slug: '/user-documentation/moderne-cli/getting-started',
        keywords: ['guides'],
      },
      items: [
        'user-documentation/moderne-cli/getting-started/cli-intro',
        {
          type: 'link' as const,
          label: 'Proof of value process',
          href: '/user-documentation/moderne-platform/getting-started/proof-of-value',
        },
        'user-documentation/moderne-cli/getting-started/moderne-cli-workshop',
        'user-documentation/moderne-cli/getting-started/moderne-cli-license',
        'user-documentation/moderne-cli/getting-started/cli-internal-mirror',
        'user-documentation/moderne-cli/getting-started/cli-internal-tools',
      ],
    },
    {
      type: 'category' as const,
      label: 'How to guides',
      link: {
        type: 'generated-index' as const,
        title: 'How to guides',
        description: 'Learn how to use the Moderne CLI.',
        slug: '/user-documentation/moderne-cli/how-to-guides',
        keywords: ['guides'],
      },
      items: [
        'user-documentation/moderne-cli/how-to-guides/cli-wrapper',
        'user-documentation/moderne-cli/how-to-guides/cli-dev-center',
        'user-documentation/moderne-cli/how-to-guides/cli-prethink',
        'user-documentation/moderne-cli/how-to-guides/curate-recipe-marketplace',
        {
          type: 'category' as const,
          label: 'Language support',
          items: [
            'user-documentation/moderne-cli/how-to-guides/csharp',
            'user-documentation/moderne-cli/how-to-guides/go',
            'user-documentation/moderne-cli/how-to-guides/java',
            'user-documentation/moderne-cli/how-to-guides/javascript',
            'user-documentation/moderne-cli/how-to-guides/python',
          ],
        },
        'user-documentation/moderne-cli/how-to-guides/parallelism',
        'user-documentation/moderne-cli/how-to-guides/ssh-key',
        'user-documentation/moderne-cli/how-to-guides/layer-config-cli',
        'user-documentation/moderne-cli/how-to-guides/code-style-config',
        'user-documentation/moderne-cli/how-to-guides/execute-user-supplied-commands',
        'user-documentation/moderne-cli/how-to-guides/on-prem-scm-config',
        'user-documentation/moderne-cli/how-to-guides/build-steps',
        'user-documentation/moderne-cli/how-to-guides/custom-build-tool-prebuild',
        'user-documentation/moderne-cli/how-to-guides/custom-parser-mappings',
        'user-documentation/moderne-cli/how-to-guides/build-partitions',
        'user-documentation/moderne-cli/how-to-guides/batch-changes',
        'user-documentation/moderne-cli/how-to-guides/managing-gradle-lock-files',
        'user-documentation/moderne-cli/how-to-guides/repos-lock-csv',
        'user-documentation/moderne-cli/how-to-guides/cli-telemetry',
        'user-documentation/moderne-cli/how-to-guides/cli-telemetry-s3-export'
      ],
    },
    'user-documentation/moderne-cli/cli-reference',
    {
      type: 'category' as const,
      label: 'References',
      link: {
        type: 'generated-index' as const,
        title: 'References',
        description: 'Reference documentation for the Moderne CLI.',
        slug: '/user-documentation/moderne-cli/references',
        keywords: ['references'],
      },
      items: [
        'user-documentation/moderne-cli/references/repos-csv',
        'user-documentation/moderne-cli/references/recipes-csv',
        'user-documentation/moderne-cli/references/cli-4-0-0-changes',
        'user-documentation/moderne-cli/references/faq',
        'user-documentation/moderne-cli/references/cli-3-45-0-changes',
        'user-documentation/moderne-cli/references/cli-3-44-0-changes',
      ],
    },
  ],
};

const agentTools = {
  type: 'category' as const,
  label: 'Agent tools',
  customProps: {
    gemIcon: 'purple',
    megaMenu: true,
    homepageHref: '/user-documentation/agent-tools/prethink',
  },
  link: {
    type: 'generated-index' as const,
    title: 'Agent tools',
    description: 'Tools and context that make AI coding agents faster, more accurate, and more effective across enterprise codebases.',
    slug: '/user-documentation/agent-tools',
    keywords: ['agent', 'tools', 'ai', 'prethink', 'trigrep', 'skills', 'mcp'],
  },
  items: [
    'user-documentation/agent-tools/prethink',
    'user-documentation/agent-tools/trigrep',
    'user-documentation/agent-tools/skills',
    {
      type: 'category' as const,
      label: 'Moderne MCP',
      link: {
        type: 'generated-index' as const,
        title: 'Moderne MCP',
        description: 'Give AI coding agents Moderne\'s tools through the Model Context Protocol. The local server runs on your workstation for semantic code search, navigation, and refactoring; the remote server, hosted on the Moderne Platform, runs recipes across an entire organization.',
        slug: '/user-documentation/agent-tools/mcp',
        keywords: ['mcp', 'model context protocol', 'security', 'architecture', 'remote', 'local'],
      },
      items: [
        {
          type: 'category' as const,
          label: 'Local server (CLI)',
          link: {
            type: 'doc' as const,
            id: 'user-documentation/agent-tools/mcp/overview',
          },
          items: [
            'user-documentation/agent-tools/mcp/getting-started',
            'user-documentation/agent-tools/mcp/tool-browser',
            'user-documentation/agent-tools/mcp/security',
          ],
        },
        'user-documentation/agent-tools/mcp/remote-server',
      ],
    },
  ],
};

const moddy = {
  type: 'category' as const,
  label: 'Moddy',
  customProps: {
    gemIcon: 'green-triangle',
    megaMenu: true,
    homepageHref: '/user-documentation/moddy/moddy-platform',
  },
  link: {
    type: 'generated-index' as const,
    title: 'Moddy',
    description: 'An AI agent that modernizes multi-repository codebases by combining LLMs with structured LST code data.',
    slug: '/user-documentation/moddy',
    keywords: ['guides'],
  },
  items: [
    'user-documentation/moddy/moddy-platform',
    'user-documentation/moddy/moddy-data-privacy',
  ],
};

const recipes = {
  type: 'category' as const,
  label: 'Recipes',
  customProps: {
    gemIcon: 'yellow-block',
    megaMenu: true,
    featured: true,
    homepageHref: '/user-documentation/recipes',
  },
  link: {
    type: 'generated-index' as const,
    title: 'Recipes',
    description: 'Structured, automatable code transformations that let you search, modernize and secure codebases accurately.',
    slug: '/user-documentation/recipes',
    keywords: ['recipes'],
  },
  items: [
    {
      type: 'category' as const,
      label: 'Recipe guides',
      link: {
        type: 'generated-index' as const,
        title: 'Recipe guides',
        description: 'Step-by-step guides for running Moderne\'s most popular migration and modernization recipes.',
        slug: '/user-documentation/recipes/popular-recipe-guides',
        keywords: ['guides', 'recipes', 'migration'],
      },
      items: [
        'user-documentation/recipes/popular-recipe-guides/migrate-to-java',
        'user-documentation/recipes/popular-recipe-guides/migrate-to-spring-boot',
        'user-documentation/recipes/popular-recipe-guides/migrate-to-jakarta-ee-10',
        'user-documentation/recipes/popular-recipe-guides/coordinating-parent-pom-migrations',
      ],
    },
    {
      type: 'category' as const,
      label: 'Recipe development',
      link: {
        type: 'generated-index' as const,
        title: 'Recipe development',
        description: 'Concepts, guides, and references for writing your own OpenRewrite recipes.',
        slug: '/user-documentation/recipes/authoring-recipes',
        keywords: ['recipes', 'authoring', 'concepts'],
      },
      items: [
        {
          type: 'category' as const,
          label: 'Set up your environment',
          link: {
            type: 'generated-index' as const,
            title: 'Set up your environment',
            description: 'Set up your local environment for writing OpenRewrite recipes.',
            slug: '/user-documentation/recipes/authoring-recipes/set-up',
            keywords: ['recipes', 'authoring', 'setup'],
          },
          items: [
            'user-documentation/recipes/authoring-recipes/set-up/recipe-development-environment',
            'user-documentation/recipes/authoring-recipes/set-up/javascript-recipe-development-environment',
          ],
        },
        {
          type: 'category' as const,
          label: 'Writing recipes',
          link: {
            type: 'generated-index' as const,
            title: 'Writing recipes',
            description: 'Guides for writing recipes in different languages and styles.',
            slug: '/user-documentation/recipes/authoring-recipes/writing-recipes',
            keywords: ['recipes', 'authoring'],
          },
          items: [
            'user-documentation/recipes/authoring-recipes/writing-recipes/types-of-recipes',
            'user-documentation/recipes/authoring-recipes/writing-recipes/writing-a-java-refactoring-recipe',
            'user-documentation/recipes/authoring-recipes/writing-recipes/writing-a-javascript-refactoring-recipe',
            'user-documentation/recipes/authoring-recipes/writing-recipes/writing-a-csharp-refactoring-recipe',
            'user-documentation/recipes/authoring-recipes/writing-recipes/writing-python-recipes',
            'user-documentation/recipes/authoring-recipes/writing-recipes/refaster-recipes',
          ],
        },
        {
          type: 'category' as const,
          label: 'Advanced techniques',
          link: {
            type: 'generated-index' as const,
            title: 'Advanced techniques',
            description: 'Advanced recipe authoring techniques.',
            slug: '/user-documentation/recipes/authoring-recipes/advanced-authoring',
            keywords: ['recipes', 'authoring', 'advanced'],
          },
          items: [
            'user-documentation/recipes/authoring-recipes/advanced-authoring/data-tables',
            'user-documentation/recipes/authoring-recipes/advanced-authoring/multiple-visitors',
            'user-documentation/recipes/authoring-recipes/advanced-authoring/writing-recipes-over-multiple-source-file-types',
            'user-documentation/recipes/authoring-recipes/advanced-authoring/multiple-versions',
            'user-documentation/recipes/authoring-recipes/advanced-authoring/automate-breaking-changes',
            'user-documentation/recipes/authoring-recipes/advanced-authoring/modifying-methods-with-javatemplate',
            'user-documentation/recipes/authoring-recipes/advanced-authoring/estimated-time-saved',
          ],
        },
        {
          type: 'category' as const,
          label: 'Testing & best practices',
          link: {
            type: 'generated-index' as const,
            title: 'Testing & best practices',
            description: 'How to test recipes and write reliable, scalable ones.',
            slug: '/user-documentation/recipes/authoring-recipes/testing-and-best-practices',
            keywords: ['recipes', 'authoring', 'testing'],
          },
          items: [
            'user-documentation/recipes/authoring-recipes/testing-and-best-practices/recipe-testing',
            'user-documentation/recipes/authoring-recipes/testing-and-best-practices/validating-recipes-at-scale',
            'user-documentation/recipes/authoring-recipes/testing-and-best-practices/recipe-conventions-and-best-practices',
          ],
        },
        {
          type: 'category' as const,
          label: 'Concepts',
          link: {
            type: 'generated-index' as const,
            title: 'Concepts',
            description: 'The building blocks behind OpenRewrite recipes: LSTs, visitors, recipes, and more.',
            slug: '/user-documentation/recipes/authoring-recipes/concepts',
            keywords: ['concepts', 'recipes', 'lst'],
          },
          items: [
            'user-documentation/recipes/authoring-recipes/concepts/recipes',
            'user-documentation/recipes/authoring-recipes/concepts/lossless-semantic-trees',
            {
              type: 'category' as const,
              label: 'LST examples',
              link: {
                type: 'generated-index' as const,
                title: 'LST examples',
                description: 'See how Java, YAML, and JavaScript code maps to OpenRewrite LST elements.',
                slug: '/user-documentation/recipes/authoring-recipes/concepts/lst-examples',
                keywords: ['lst', 'examples', 'concepts'],
              },
              items: [
                'user-documentation/recipes/authoring-recipes/concepts/lst-examples/java',
                'user-documentation/recipes/authoring-recipes/concepts/lst-examples/yaml',
                'user-documentation/recipes/authoring-recipes/concepts/lst-examples/javascript',
              ],
            },
            'user-documentation/recipes/authoring-recipes/concepts/type-attribution',
            'user-documentation/recipes/authoring-recipes/concepts/visitors',
            'user-documentation/recipes/authoring-recipes/concepts/cursors',
            'user-documentation/recipes/authoring-recipes/concepts/markers',
            'user-documentation/recipes/authoring-recipes/concepts/traits',
            'user-documentation/recipes/authoring-recipes/concepts/styles',
            'user-documentation/recipes/authoring-recipes/concepts/javatemplate',
            'user-documentation/recipes/authoring-recipes/concepts/tree-visiting-printer',
            'user-documentation/recipes/authoring-recipes/concepts/quarks',
          ],
        },
        {
          type: 'category' as const,
          label: 'References',
          link: {
            type: 'generated-index' as const,
            title: 'References',
            description: 'Reference material for writing OpenRewrite recipes.',
            slug: '/user-documentation/recipes/authoring-recipes/references',
            keywords: ['recipes', 'authoring', 'reference'],
          },
          items: [
            'user-documentation/recipes/authoring-recipes/references/yaml-format-reference',
            'user-documentation/recipes/authoring-recipes/references/method-patterns',
            'user-documentation/recipes/authoring-recipes/references/jsonpath-and-jsonpathmatcher-reference',
            'user-documentation/recipes/authoring-recipes/references/dependency-version-selectors',
            'user-documentation/recipes/authoring-recipes/references/framework-provided-markers',
            'user-documentation/recipes/authoring-recipes/references/type-attribution',
          ],
        },
      ],
    },
    {
      type: 'category' as const,
      label: 'Catalog',
      link: {
        type: 'generated-index' as const,
        title: 'Catalog',
        description: 'Browse all available OpenRewrite and Moderne recipes.',
        slug: '/user-documentation/recipes/recipe-catalog',
        keywords: ['recipes', 'catalog'],
      },
      items: [
        { type: 'autogenerated' as const, dirName: 'user-documentation/recipes/recipe-catalog' }
      ],
    },
    {
      type: 'category' as const,
      label: 'Lists',
      link: {
        type: 'generated-index' as const,
        title: 'Recipe lists',
        description: 'Browse recipes organized by module, tag, and more.',
        slug: '/user-documentation/recipes/lists',
        keywords: ['recipes', 'lists'],
      },
      items: [
        'user-documentation/recipes/lists/all-recipes',
        'user-documentation/recipes/lists/recipes-by-tag',
        'user-documentation/recipes/lists/recipes-with-data-tables',
        'user-documentation/recipes/lists/scanning-recipes',
        'user-documentation/recipes/lists/standalone-recipes',
        'user-documentation/recipes/lists/latest-versions-of-every-openrewrite-module',
      ],
    },
  ],
};

const jetbrainsPlugin = {
  type: 'category' as const,
  label: 'IDE plugins',
  customProps: {
    gemIcon: 'pink-large',
    megaMenu: true,
    homepageHref: '/user-documentation/moderne-ide-integration/how-to-guides/moderne-plugin-install',
  },
  link: {
    type: 'generated-index' as const,
    title: 'Moderne IDE plugins',
    description: 'An IntelliJ IDE plugin for multi-repository code search and recipe development.',
    slug: '/user-documentation/moderne-ide-integration',
    keywords: ['guides'],
  },
  items: [
    {
      type: 'category' as const,
      label: 'How to guides',
      link: {
        type: 'generated-index' as const,
        title: 'How to guides',
        description: 'Learn how to work with the Moderne IntelliJ IDEA plugin.',
        slug: '/user-documentation/moderne-ide-integration/how-to-guides',
        keywords: ['guides'],
      },
      items: [
        'user-documentation/moderne-ide-integration/how-to-guides/moderne-plugin-install',
        'user-documentation/moderne-ide-integration/how-to-guides/code-search',
        'user-documentation/moderne-ide-integration/how-to-guides/creating-recipes',
        'user-documentation/moderne-ide-integration/how-to-guides/debugging-recipes',
      ],
    },
    {
      type: 'category' as const,
      label: 'Reference',
      link: {
        type: 'generated-index' as const,
        title: 'Reference',
        description: 'Reference documentation for Moderne IDE integrations.',
        slug: '/user-documentation/moderne-ide-integration/reference',
        keywords: ['reference'],
      },
      items: [
        'user-documentation/moderne-ide-integration/reference/code-search-actions',
        'user-documentation/moderne-ide-integration/reference/refactor-actions',
      ],
    },
  ],
};

// Topic-based sections
const handsOnLearning = {
  type: 'category' as const,
  label: 'Hands-on learning',
  customProps: {
    gemIcon: 'pink',
    featured: true,
  },
  link: {
    type: 'doc' as const,
    id: 'hands-on-learning',
  },
  items: [
    {
      type: 'category' as const,
      label: 'Introduction to OpenRewrite',
      link: {
        type: 'generated-index' as const,
        title: 'Introduction to OpenRewrite',
        description: 'Learn how OpenRewrite works and get hands-on experience running recipes.',
        slug: '/hands-on-learning/introduction',
        keywords: ['recipes'],
      },
      items: [
        'hands-on-learning/introduction/workshop-overview',
        'hands-on-learning/introduction/module-1-running-recipes',
        'hands-on-learning/introduction/module-2-recipe-builder',
        'hands-on-learning/introduction/module-3-data-tables-visualizations',
        'hands-on-learning/introduction/module-4-devcenter',
      ],
    },
    {
      type: 'category' as const,
      label: 'Fundamentals of recipe development',
      link: {
        type: 'generated-index' as const,
        title: 'Fundamentals of recipe development workshop',
        description: 'Learn how OpenRewrite works and get hands-on experience developing recipes.',
        slug: '/hands-on-learning/fundamentals',
        keywords: ['recipes'],
      },
      items: [
        'hands-on-learning/fundamentals/workshop-overview',
        'hands-on-learning/fundamentals/module-1-recipe-development-environment',
        'hands-on-learning/fundamentals/module-2-declarative-yaml-recipes',
        'hands-on-learning/fundamentals/module-3-refaster-recipes',
        'hands-on-learning/fundamentals/module-4-imperative-recipes',
      ],
    },
    {
      type: 'category' as const,
      label: 'Advanced recipe development',
      link: {
        type: 'generated-index' as const,
        title: 'Advanced recipe development workshop',
        description: 'Learn to build advanced recipes that can extract insights and generate code.',
        slug: '/hands-on-learning/advanced',
        keywords: ['recipes'],
      },
      items: [
        'hands-on-learning/advanced/workshop-overview',
        'hands-on-learning/advanced/module-1-recipe-development-environment',
        'hands-on-learning/advanced/module-2-data-tables',
        'hands-on-learning/advanced/module-3-scanning-recipes',
        'hands-on-learning/advanced/module-4-traits',
      ],
    },
    {
      type: 'category' as const,
      label: 'Preparing for a Spring Boot Migration',
      link: {
        type: 'generated-index' as const,
        title: 'Preparing for a Spring Boot Migration',
        description: 'Plan and execute a Spring Boot 4 migration with wave-based upgrades.',
        slug: '/hands-on-learning/spring-boot-migration',
        keywords: ['training', 'recipes'],
      },
      items: [
        'hands-on-learning/spring-boot-migration/workshop-overview',
        'hands-on-learning/spring-boot-migration/module-1-migration-assessment',
        'hands-on-learning/spring-boot-migration/module-2-wave-planning',
        'hands-on-learning/spring-boot-migration/module-3-establish-baseline',
        'hands-on-learning/spring-boot-migration/module-4-smoke-test',
        'hands-on-learning/spring-boot-migration/module-5-build-querydsl-recipe',
        'hands-on-learning/spring-boot-migration/module-6-wave-migration',
      ],
    },
    {
      type: 'category' as const,
      label: 'AI-assisted recipe authoring',
      link: {
        type: 'generated-index' as const,
        title: 'Teaching AI to write better OpenRewrite recipes',
        description: 'Learn to use AI as a co-author for building OpenRewrite migration recipes, using the Moderne CLI\'s built-in AI skills.',
        slug: '/hands-on-learning/ai-recipes',
        keywords: ['ai', 'recipes', 'skills'],
      },
      items: [
        'hands-on-learning/ai-recipes/workshop-overview',
        'hands-on-learning/ai-recipes/module-1-plan',
        'hands-on-learning/ai-recipes/module-2-build',
        'hands-on-learning/ai-recipes/module-3-test',
      ],
    },
    {
      type: 'category' as const,
      label: 'Agent tools for AI coding agents',
      link: {
        type: 'generated-index' as const,
        title: 'Agent tools for AI coding agents',
        description: 'Set up the Moderne agent tools and use Prethink, Trigrep, and the MCP server with your AI coding agent.',
        slug: '/hands-on-learning/agent-tools',
        keywords: ['ai', 'agent-tools', 'skills', 'mcp', 'prethink', 'trigrep'],
      },
      items: [
        'hands-on-learning/agent-tools/workshop-overview',
        'hands-on-learning/agent-tools/module-1-cli-and-lsts',
        'hands-on-learning/agent-tools/module-2-install-agent-tools',
        'hands-on-learning/agent-tools/module-3-prethink',
        'hands-on-learning/agent-tools/module-4-trigrep',
        'hands-on-learning/agent-tools/module-5-mcp',
      ],
    },
    {
      type: 'link' as const,
      label: 'Live OpenRewrite training',
      description: 'Hands-on sessions for both newcomers and advanced practitioners.',
      href: 'https://www.moderne.ai/moderne-openrewrite-training-hub',
    },
  ],
};

const openRewriteAdvanced = {
  type: 'category' as const,
  label: 'OpenRewrite Advanced Program Analysis',
  customProps: {
    featured: true,
  },
  link: {
    type: 'generated-index' as const,
    title: 'OpenRewrite Advanced Program Analysis',
    description: 'In-depth guides on control flow, data flow, taint analysis, and security vulnerability detection.',
    slug: '/openrewrite-advanced-program-analysis',
    keywords: ['analysis', 'control-flow', 'data-flow', 'taint', 'security'],
  },
  items: [
    {
      type: 'category' as const,
      label: 'Control flow',
      link: {
        type: 'generated-index' as const,
        title: 'Control flow analysis',
        description: 'Learn about control flow analysis in OpenRewrite.',
        slug: '/openrewrite-advanced-program-analysis/control-flow',
        keywords: ['control-flow', 'cfg', 'analysis'],
      },
      items: [
        'openrewrite-advanced-program-analysis/control-flow/introduction',
        'openrewrite-advanced-program-analysis/control-flow/building-cfgs',
        'openrewrite-advanced-program-analysis/control-flow/reachability-analysis',
        'openrewrite-advanced-program-analysis/control-flow/dominance-analysis',
        'openrewrite-advanced-program-analysis/control-flow/loop-analysis',
      ],
    },
    {
      type: 'category' as const,
      label: 'Data flow',
      link: {
        type: 'generated-index' as const,
        title: 'Data flow analysis',
        description: 'Learn about data flow analysis in OpenRewrite.',
        slug: '/openrewrite-advanced-program-analysis/data-flow',
        keywords: ['data-flow', 'analysis'],
      },
      items: [
        'openrewrite-advanced-program-analysis/data-flow/introduction',
        'openrewrite-advanced-program-analysis/data-flow/building-your-first-data-flow-analysis',
        'openrewrite-advanced-program-analysis/data-flow/liveness-analysis',
        'openrewrite-advanced-program-analysis/data-flow/reaching-definitions',
        'openrewrite-advanced-program-analysis/data-flow/inter-procedural-analysis',
        'openrewrite-advanced-program-analysis/data-flow/method-summary-analysis',
      ],
    },
    {
      type: 'category' as const,
      label: 'Taint analysis',
      link: {
        type: 'generated-index' as const,
        title: 'Taint analysis',
        description: 'Learn about taint analysis for security vulnerability detection.',
        slug: '/openrewrite-advanced-program-analysis/taint-analysis',
        keywords: ['taint', 'security', 'analysis'],
      },
      items: [
        'openrewrite-advanced-program-analysis/taint-analysis/introduction',
        'openrewrite-advanced-program-analysis/taint-analysis/comprehensive-guide',
      ],
    },
    {
      type: 'category' as const,
      label: 'Security',
      link: {
        type: 'generated-index' as const,
        title: 'Security analysis',
        description: 'Learn how to find and fix security vulnerabilities using OpenRewrite.',
        slug: '/openrewrite-advanced-program-analysis/security',
        keywords: ['security', 'vulnerabilities', 'analysis'],
      },
      items: [
        'openrewrite-advanced-program-analysis/security/overview',
        'openrewrite-advanced-program-analysis/security/sql-injection',
        'openrewrite-advanced-program-analysis/security/xss',
        'openrewrite-advanced-program-analysis/security/command-injection',
        'openrewrite-advanced-program-analysis/security/ldap-injection',
        'openrewrite-advanced-program-analysis/security/path-traversal',
        'openrewrite-advanced-program-analysis/security/xxe',
        'openrewrite-advanced-program-analysis/security/pii-protection',
        'openrewrite-advanced-program-analysis/security/post-quantum-cryptography',
      ],
    },
    'openrewrite-advanced-program-analysis/advanced-analysis-techniques',
  ],
};

const releases = {
  type: 'category' as const,
  label: 'Releases',
  customProps: {
    gemIcon: 'gray',
  },
  link: {
    type: 'generated-index' as const,
    title: 'Releases',
    description: 'Release notes and changelogs for Moderne products including the Agent, CLI, DX, and recipes.',
    slug: '/releases',
    keywords: ['releases', 'changelog'],
  },
  items: [
    'releases/connector-releases',
    'releases/agent-releases',
    'releases/cli-releases',
    'releases/changelog',
    'releases/proprietary-recipe-changelog',
    'releases/saas-v2-changes',
    'releases/saas-v2-migration',
    'releases/saas-v2-property-mapping',
  ],
};

const licensing = {
  type: 'category' as const,
  label: 'Licensing',
  customProps: {
    gemIcon: 'orange',
  },
  link: {
    type: 'generated-index' as const,
    title: 'Licensing',
    description: 'Licensing information for Moderne products and the Moderne Source Available License.',
    slug: '/licensing',
    keywords: ['licensing', 'license'],
  },
  items: [
    'licensing/overview',
    'licensing/moderne-source-available-license',
  ],
};

// Final sidebar composition
const sidebars: SidebarsConfig = {
  docs: [
    platform.practitioner,
    cli,
    agentTools,
    moddy,
    jetbrainsPlugin,
    recipes,
    {
      type: 'category',
      label: 'Code Remix sessions',
      items: [
        'user-documentation/code-remix-sessions/2026',
        'user-documentation/code-remix-sessions/2025',
        'user-documentation/code-remix-sessions/2024',
      ],
    },
    handsOnLearning,
    openRewriteAdvanced,
    platform.admin,
    platformV1.practitioner,
    platformV1.admin,
    dx,
    releases,
    licensing,
  ]
};

export default sidebars;