mirror of
				https://github.com/datahub-project/datahub.git
				synced 2025-10-31 10:49:00 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			1231 lines
		
	
	
		
			35 KiB
		
	
	
	
		
			JavaScript
		
	
	
	
	
	
			
		
		
	
	
			1231 lines
		
	
	
		
			35 KiB
		
	
	
	
		
			JavaScript
		
	
	
	
	
	
| // note: to handle errors where you don't want a markdown file in the sidebar, add it as a comment.
 | |
| // this will fix errors like `Error: File not accounted for in sidebar: ...`
 | |
| // smoke-test/tests/library_examples/README.md
 | |
| module.exports = {
 | |
|   overviewSidebar: [
 | |
|     // Getting Started.
 | |
|     {
 | |
|       type: "html",
 | |
|       value: "<div>Getting Started</div>",
 | |
|       defaultStyle: true,
 | |
|     },
 | |
|     {
 | |
|       label: "What Is DataHub?",
 | |
|       type: "category",
 | |
|       collapsed: true,
 | |
|       link: { type: "doc", id: "docs/features" },
 | |
|       items: [
 | |
|         // By the end of this section, readers should understand the core use cases that DataHub addresses,
 | |
|         // target end-users, high-level architecture, & hosting options
 | |
|         {
 | |
|           type: "doc",
 | |
|           label: "Quickstart",
 | |
|           id: "docs/quickstart",
 | |
|         },
 | |
|         {
 | |
|           type: "link",
 | |
|           label: "Demo",
 | |
|           href: "https://demo.datahub.com/",
 | |
|         },
 | |
|         {
 | |
|           type: "link",
 | |
|           label: "Customer Stories",
 | |
|           href: "https://datahub.com/resources/?2004611554=dh-stories",
 | |
|         },
 | |
|       ],
 | |
|     },
 | |
|     {
 | |
|       type: "category",
 | |
|       label: "Features",
 | |
|       link: {
 | |
|         type: "generated-index",
 | |
|         title: "Feature Guides",
 | |
|         description: "Learn about the features of DataHub.",
 | |
|       },
 | |
|       items: [
 | |
|         // "docs/how/ui-tabs-guide",
 | |
|         {
 | |
|           label: "Assertions (Data Quality)",
 | |
|           type: "category",
 | |
|           link: { type: "doc", id: "docs/managed-datahub/observe/assertions" },
 | |
|           items: [
 | |
|             {
 | |
|               label: "Overview",
 | |
|               type: "doc",
 | |
|               id: "docs/managed-datahub/observe/assertions",
 | |
|             },
 | |
|             {
 | |
|               label: "Column Assertions",
 | |
|               type: "doc",
 | |
|               id: "docs/managed-datahub/observe/column-assertions",
 | |
|               className: "saasOnly",
 | |
|             },
 | |
|             {
 | |
|               label: "Custom SQL Assertions",
 | |
|               type: "doc",
 | |
|               id: "docs/managed-datahub/observe/custom-sql-assertions",
 | |
|               className: "saasOnly",
 | |
|             },
 | |
|             {
 | |
|               label: "Freshness Assertions",
 | |
|               type: "doc",
 | |
|               id: "docs/managed-datahub/observe/freshness-assertions",
 | |
|               className: "saasOnly",
 | |
|             },
 | |
|             {
 | |
|               label: "Schema Assertions",
 | |
|               type: "doc",
 | |
|               id: "docs/managed-datahub/observe/schema-assertions",
 | |
|               className: "saasOnly",
 | |
|             },
 | |
|             {
 | |
|               label: "Volume Assertions",
 | |
|               type: "doc",
 | |
|               id: "docs/managed-datahub/observe/volume-assertions",
 | |
|               className: "saasOnly",
 | |
|             },
 | |
|             {
 | |
|               label: "Smart Assertions ⚡ (Anomaly Detection)",
 | |
|               type: "doc",
 | |
|               id: "docs/managed-datahub/observe/smart-assertions",
 | |
|               className: "saasOnly",
 | |
|             },
 | |
|             {
 | |
|               label: "Data Health Dashboard",
 | |
|               type: "doc",
 | |
|               id: "docs/managed-datahub/observe/data-health-dashboard",
 | |
|               className: "saasOnly",
 | |
|             },
 | |
|             {
 | |
|               label: "Adding Notes to Assertions",
 | |
|               type: "doc",
 | |
|               id: "docs/managed-datahub/observe/assertion-notes",
 | |
|               className: "saasOnly",
 | |
|             },
 | |
|             {
 | |
|               label: "Open Assertions Specification",
 | |
|               type: "category",
 | |
|               link: { type: "doc", id: "docs/assertions/open-assertions-spec" },
 | |
|               items: [
 | |
|                 {
 | |
|                   label: "Snowflake",
 | |
|                   type: "doc",
 | |
|                   id: "docs/assertions/snowflake/snowflake_dmfs",
 | |
|                 },
 | |
|               ],
 | |
|             },
 | |
|           ],
 | |
|         },
 | |
|         {
 | |
|           label: "Data Access Workflows",
 | |
|           type: "doc",
 | |
|           id: "docs/managed-datahub/workflows/access-workflows",
 | |
|         },
 | |
|         {
 | |
|           label: "Data Access Roles",
 | |
|           type: "doc",
 | |
|           id: "docs/features/feature-guides/access-roles",
 | |
|         },
 | |
|         {
 | |
|           label: "Applications",
 | |
|           type: "doc",
 | |
|           id: "docs/features/feature-guides/applications",
 | |
|         },
 | |
|         {
 | |
|           label: "Automations",
 | |
|           type: "category",
 | |
|           collapsed: true,
 | |
|           items: [
 | |
|             {
 | |
|               label: "Documentation Propagation",
 | |
|               type: "doc",
 | |
|               id: "docs/automations/docs-propagation",
 | |
|             },
 | |
|             {
 | |
|               label: "Glossary Term Propagation",
 | |
|               type: "doc",
 | |
|               id: "docs/automations/glossary-term-propagation",
 | |
|             },
 | |
|             {
 | |
|               label: "BigQuery Metadata Sync",
 | |
|               type: "doc",
 | |
|               id: "docs/automations/bigquery-metadata-sync",
 | |
|               className: "saasOnly",
 | |
|             },
 | |
|             {
 | |
|               label: "Databricks Metadata Sync",
 | |
|               type: "doc",
 | |
|               id: "docs/automations/databricks-metadata-sync",
 | |
|               className: "saasOnly",
 | |
|             },
 | |
|             {
 | |
|               label: "Snowflake Tag Sync",
 | |
|               type: "doc",
 | |
|               id: "docs/automations/snowflake-tag-propagation",
 | |
|               className: "saasOnly",
 | |
|             },
 | |
|             {
 | |
|               label: "AI Classification",
 | |
|               type: "doc",
 | |
|               id: "docs/automations/ai-term-suggestion",
 | |
|               className: "saasOnly",
 | |
|             },
 | |
|             {
 | |
|               label: "AI Documentation",
 | |
|               type: "doc",
 | |
|               id: "docs/automations/ai-docs",
 | |
|               className: "saasOnly",
 | |
|             },
 | |
|           ],
 | |
|         },
 | |
|         {
 | |
|           label: "Business Attributes",
 | |
|           type: "doc",
 | |
|           id: "docs/businessattributes",
 | |
|         },
 | |
|         {
 | |
|           label: "Business Glossary",
 | |
|           type: "doc",
 | |
|           id: "docs/glossary/business-glossary",
 | |
|         },
 | |
|         {
 | |
|           label: "Compliance Forms",
 | |
|           type: "category",
 | |
|           collapsed: true,
 | |
|           items: [
 | |
|             {
 | |
|               type: "doc",
 | |
|               id: "docs/features/feature-guides/compliance-forms/overview",
 | |
|             },
 | |
|             {
 | |
|               type: "doc",
 | |
|               id: "docs/features/feature-guides/compliance-forms/create-a-form",
 | |
|             },
 | |
|             {
 | |
|               type: "doc",
 | |
|               id: "docs/features/feature-guides/compliance-forms/complete-a-form",
 | |
|             },
 | |
|             {
 | |
|               type: "doc",
 | |
|               id: "docs/features/feature-guides/compliance-forms/analytics",
 | |
|               className: "saasOnly",
 | |
|             },
 | |
|           ],
 | |
|         },
 | |
|         {
 | |
|           label: "Custom Asset Summaries",
 | |
|           type: "doc",
 | |
|           id: "docs/features/feature-guides/custom-asset-summaries",
 | |
|         },
 | |
|         {
 | |
|           label: "Custom Home Page",
 | |
|           type: "doc",
 | |
|           id: "docs/features/feature-guides/custom-home-page",
 | |
|         },
 | |
|         {
 | |
|           label: "Data Contract",
 | |
|           type: "doc",
 | |
|           id: "docs/managed-datahub/observe/data-contract",
 | |
|         },
 | |
|         {
 | |
|           label: "Data Products",
 | |
|           type: "doc",
 | |
|           id: "docs/dataproducts",
 | |
|         },
 | |
|         {
 | |
|           label: "Dataset Usage and Query History",
 | |
|           type: "doc",
 | |
|           id: "docs/features/dataset-usage-and-query-history",
 | |
|         },
 | |
|         {
 | |
|           label: "Domains",
 | |
|           type: "doc",
 | |
|           id: "docs/domains",
 | |
|         },
 | |
|         {
 | |
|           label: "Incidents",
 | |
|           type: "doc",
 | |
|           id: "docs/incidents/incidents",
 | |
|         },
 | |
|         {
 | |
|           label: "Ingestion",
 | |
|           type: "doc",
 | |
|           id: "docs/ui-ingestion",
 | |
|         },
 | |
|         {
 | |
|           label: "Lineage",
 | |
|           type: "category",
 | |
|           link: {
 | |
|             type: "doc",
 | |
|             id: "docs/features/feature-guides/lineage",
 | |
|           },
 | |
|           items: [
 | |
|             {
 | |
|               label: "Automatic Lineage Extraction",
 | |
|               type: "doc",
 | |
|               id: "docs/generated/lineage/automatic-lineage-extraction",
 | |
|             },
 | |
|             {
 | |
|               label: "Lineage Impact Analysis",
 | |
|               type: "doc",
 | |
|               id: "docs/act-on-metadata/impact-analysis",
 | |
|             },
 | |
|             {
 | |
|               label: "Managing Lineage via UI",
 | |
|               type: "doc",
 | |
|               id: "docs/features/feature-guides/ui-lineage",
 | |
|             },
 | |
|           ],
 | |
|         },
 | |
|         {
 | |
|           label: "Logical Models",
 | |
|           type: "category",
 | |
|           link: {
 | |
|             type: "doc",
 | |
|             id: "docs/features/feature-guides/logical-models/overview",
 | |
|           },
 | |
|           items: [
 | |
|             {
 | |
|               label: "Overview",
 | |
|               type: "doc",
 | |
|               id: "docs/features/feature-guides/logical-models/overview",
 | |
|             },
 | |
|             {
 | |
|               label: "Centralized Management",
 | |
|               type: "doc",
 | |
|               id: "docs/features/feature-guides/logical-models/centralized-management",
 | |
|               className: "saasOnly",
 | |
|             },
 | |
|           ],
 | |
|         },
 | |
|         {
 | |
|           label: "Metadata Tests",
 | |
|           type: "doc",
 | |
|           id: "docs/tests/metadata-tests",
 | |
|           className: "saasOnly",
 | |
|         },
 | |
|         {
 | |
|           label: "MCP Server",
 | |
|           type: "doc",
 | |
|           id: "docs/features/feature-guides/mcp",
 | |
|         },
 | |
|         {
 | |
|           label: "Ownership",
 | |
|           type: "doc",
 | |
|           id: "docs/ownership/ownership-types",
 | |
|         },
 | |
|         {
 | |
|           label: "Policies",
 | |
|           type: "doc",
 | |
|           id: "docs/authorization/access-policies-guide",
 | |
|         },
 | |
|         {
 | |
|           label: "Posts",
 | |
|           type: "doc",
 | |
|           id: "docs/posts",
 | |
|         },
 | |
|         {
 | |
|           label: "Properties",
 | |
|           type: "category",
 | |
|           collapsed: true,
 | |
|           items: [
 | |
|             {
 | |
|               type: "doc",
 | |
|               id: "docs/features/feature-guides/properties/overview",
 | |
|             },
 | |
|             {
 | |
|               type: "doc",
 | |
|               id: "docs/features/feature-guides/properties/create-a-property",
 | |
|             },
 | |
|           ],
 | |
|         },
 | |
|         {
 | |
|           label: "Schema history",
 | |
|           type: "doc",
 | |
|           id: "docs/schema-history",
 | |
|         },
 | |
|         {
 | |
|           label: "Search",
 | |
|           type: "doc",
 | |
|           id: "docs/how/search",
 | |
|         },
 | |
|         {
 | |
|           label: "Sync Status",
 | |
|           type: "doc",
 | |
|           id: "docs/sync-status",
 | |
|         },
 | |
|         {
 | |
|           label: "Tags",
 | |
|           type: "doc",
 | |
|           id: "docs/tags",
 | |
|         },
 | |
|       ],
 | |
|     },
 | |
|     // DataHub Cloud.
 | |
|     {
 | |
|       type: "html",
 | |
|       value: "<div>DataHub Cloud</div>",
 | |
|       defaultStyle: true,
 | |
|     },
 | |
|     {
 | |
|       label: "DataHub Cloud Overview",
 | |
|       type: "doc",
 | |
|       id: "docs/managed-datahub/managed-datahub-overview",
 | |
|     },
 | |
|     {
 | |
|       type: "doc",
 | |
|       id: "docs/managed-datahub/welcome-acryl",
 | |
|     },
 | |
|     {
 | |
|       label: "Upgrading from DataHub Core to Cloud",
 | |
|       type: "doc",
 | |
|       id: "docs/managed-datahub/upgrade_core_to_cloud",
 | |
|     },
 | |
|     {
 | |
|       "Configure Single Sign-On": [
 | |
|         {
 | |
|           type: "doc",
 | |
|           id: "docs/authentication/guides/sso/initialize-oidc",
 | |
|           className: "saasOnly",
 | |
|         },
 | |
|         {
 | |
|           type: "doc",
 | |
|           id: "docs/managed-datahub/integrations/oidc-sso-integration",
 | |
|           className: "saasOnly",
 | |
|         },
 | |
|       ],
 | |
|     },
 | |
|     {
 | |
|       "Remote Executor": [
 | |
|         {
 | |
|           type: "doc",
 | |
|           id: "docs/managed-datahub/remote-executor/about",
 | |
|           className: "saasOnly",
 | |
|         },
 | |
|         {
 | |
|           type: "doc",
 | |
|           id: "docs/managed-datahub/operator-guide/setting-up-remote-ingestion-executor",
 | |
|           className: "saasOnly",
 | |
|         },
 | |
|         {
 | |
|           type: "doc",
 | |
|           id: "docs/managed-datahub/remote-executor/monitoring",
 | |
|           className: "saasOnly",
 | |
|         },
 | |
|       ],
 | |
|     },
 | |
|     {
 | |
|       "DataHub API": [
 | |
|         {
 | |
|           type: "doc",
 | |
|           id: "docs/managed-datahub/datahub-api/entity-events-api",
 | |
|           className: "saasOnly",
 | |
|         },
 | |
|         {
 | |
|           "GraphQL API": [
 | |
|             "docs/managed-datahub/datahub-api/graphql-api/getting-started",
 | |
|           ],
 | |
|         },
 | |
|       ],
 | |
|     },
 | |
|     {
 | |
|       Slack: [
 | |
|         {
 | |
|           type: "doc",
 | |
|           id: "docs/managed-datahub/slack/saas-slack-app",
 | |
|           className: "saasOnly",
 | |
|         },
 | |
|         {
 | |
|           type: "doc",
 | |
|           id: "docs/managed-datahub/slack/saas-slack-setup",
 | |
|           className: "saasOnly",
 | |
|         },
 | |
|         {
 | |
|           type: "doc",
 | |
|           id: "docs/managed-datahub/slack/saas-slack-troubleshoot",
 | |
|           className: "saasOnly",
 | |
|         },
 | |
|       ],
 | |
|     },
 | |
|     {
 | |
|       Teams: [
 | |
|         {
 | |
|           type: "doc",
 | |
|           id: "docs/managed-datahub/teams/saas-teams-app",
 | |
|           className: "saasOnly",
 | |
|         },
 | |
|         {
 | |
|           type: "doc",
 | |
|           id: "docs/managed-datahub/teams/saas-teams-setup",
 | |
|           className: "saasOnly",
 | |
|         },
 | |
|       ],
 | |
|     },
 | |
|     {
 | |
|       "Operator Guides": [
 | |
|         {
 | |
|           type: "doc",
 | |
|           id: "docs/managed-datahub/operator-guide/setting-up-events-api-on-aws-eventbridge",
 | |
|           className: "saasOnly",
 | |
|         },
 | |
|         {
 | |
|           type: "doc",
 | |
|           id: "docs/managed-datahub/integrations/aws-privatelink",
 | |
|           className: "saasOnly",
 | |
|         },
 | |
|       ],
 | |
|     },
 | |
|     {
 | |
|       type: "doc",
 | |
|       id: "docs/managed-datahub/change-proposals",
 | |
|       className: "saasOnly",
 | |
|     },
 | |
|     {
 | |
|       type: "doc",
 | |
|       id: "docs/managed-datahub/chrome-extension",
 | |
|     },
 | |
|     {
 | |
|       type: "doc",
 | |
|       id: "docs/managed-datahub/subscription-and-notification",
 | |
|       className: "saasOnly",
 | |
|     },
 | |
|     {
 | |
|       "DataHub Cloud Release History": [
 | |
|         "docs/managed-datahub/release-notes/v_0_3_14",
 | |
|         "docs/managed-datahub/release-notes/v_0_3_13",
 | |
|         "docs/managed-datahub/release-notes/v_0_3_12",
 | |
|         "docs/managed-datahub/release-notes/v_0_3_11",
 | |
|         "docs/managed-datahub/release-notes/v_0_3_10",
 | |
|         "docs/managed-datahub/release-notes/v_0_3_9",
 | |
|         "docs/managed-datahub/release-notes/v_0_3_8",
 | |
|         "docs/managed-datahub/release-notes/v_0_3_7",
 | |
|         "docs/managed-datahub/release-notes/v_0_3_6",
 | |
|         "docs/managed-datahub/release-notes/v_0_3_5",
 | |
|         "docs/managed-datahub/release-notes/v_0_3_4",
 | |
|         "docs/managed-datahub/release-notes/v_0_3_3",
 | |
|         "docs/managed-datahub/release-notes/v_0_3_2",
 | |
|         "docs/managed-datahub/release-notes/v_0_3_1",
 | |
|         "docs/managed-datahub/release-notes/v_0_2_16",
 | |
|         "docs/managed-datahub/release-notes/v_0_2_15",
 | |
|         "docs/managed-datahub/release-notes/v_0_2_14",
 | |
|         "docs/managed-datahub/release-notes/v_0_2_13",
 | |
|         "docs/managed-datahub/release-notes/v_0_2_12",
 | |
|         "docs/managed-datahub/release-notes/v_0_2_11",
 | |
|         "docs/managed-datahub/release-notes/v_0_2_10",
 | |
|         "docs/managed-datahub/release-notes/v_0_2_9",
 | |
|         "docs/managed-datahub/release-notes/v_0_2_8",
 | |
|         "docs/managed-datahub/release-notes/v_0_2_7",
 | |
|         "docs/managed-datahub/release-notes/v_0_2_6",
 | |
|         "docs/managed-datahub/release-notes/v_0_2_5",
 | |
|         "docs/managed-datahub/release-notes/v_0_2_4",
 | |
|         "docs/managed-datahub/release-notes/v_0_2_3",
 | |
|         "docs/managed-datahub/release-notes/v_0_2_2",
 | |
|         "docs/managed-datahub/release-notes/v_0_2_1",
 | |
|         "docs/managed-datahub/release-notes/v_0_2_0",
 | |
|         "docs/managed-datahub/release-notes/v_0_1_73",
 | |
|         "docs/managed-datahub/release-notes/v_0_1_72",
 | |
|         "docs/managed-datahub/release-notes/v_0_1_70",
 | |
|         "docs/managed-datahub/release-notes/v_0_1_69",
 | |
|       ],
 | |
|     },
 | |
|     // Integrations.
 | |
|     {
 | |
|       type: "html",
 | |
|       value: "<div>Integrations</div>",
 | |
|       defaultStyle: true,
 | |
|     },
 | |
|     {
 | |
|       type: "category",
 | |
|       link: {
 | |
|         type: "doc",
 | |
|         id: "metadata-ingestion/README",
 | |
|       },
 | |
|       label: "Overview",
 | |
|       items: [
 | |
|         {
 | |
|           type: "doc",
 | |
|           label: "Recipe",
 | |
|           id: "metadata-ingestion/recipe_overview",
 | |
|         },
 | |
|         {
 | |
|           type: "category",
 | |
|           label: "Sinks",
 | |
|           link: { type: "doc", id: "metadata-ingestion/sink_overview" },
 | |
|           items: [
 | |
|             {
 | |
|               type: "autogenerated",
 | |
|               dirName: "metadata-ingestion/sink_docs",
 | |
|             },
 | |
|           ],
 | |
|         },
 | |
|         {
 | |
|           type: "category",
 | |
|           label: "Transformers",
 | |
|           link: {
 | |
|             type: "doc",
 | |
|             id: "metadata-ingestion/docs/transformer/intro",
 | |
|           },
 | |
|           items: [
 | |
|             "metadata-ingestion/docs/transformer/dataset_transformer",
 | |
|             "metadata-ingestion/docs/transformer/universal_transformers",
 | |
|           ],
 | |
|         },
 | |
|       ],
 | |
|     },
 | |
|     {
 | |
|       "Quickstart Guides": [
 | |
|         "metadata-ingestion/cli-ingestion",
 | |
|         {
 | |
|           BigQuery: [
 | |
|             "docs/quick-ingestion-guides/bigquery/overview",
 | |
|             "docs/quick-ingestion-guides/bigquery/setup",
 | |
|             "docs/quick-ingestion-guides/bigquery/configuration",
 | |
|           ],
 | |
|         },
 | |
|         {
 | |
|           Redshift: [
 | |
|             "docs/quick-ingestion-guides/redshift/overview",
 | |
|             "docs/quick-ingestion-guides/redshift/setup",
 | |
|             "docs/quick-ingestion-guides/redshift/configuration",
 | |
|           ],
 | |
|         },
 | |
|         {
 | |
|           Snowflake: [
 | |
|             "docs/quick-ingestion-guides/snowflake/overview",
 | |
|             "docs/quick-ingestion-guides/snowflake/setup",
 | |
|             "docs/quick-ingestion-guides/snowflake/configuration",
 | |
|           ],
 | |
|         },
 | |
|         {
 | |
|           Tableau: [
 | |
|             "docs/quick-ingestion-guides/tableau/overview",
 | |
|             "docs/quick-ingestion-guides/tableau/setup",
 | |
|             "docs/quick-ingestion-guides/tableau/configuration",
 | |
|           ],
 | |
|         },
 | |
|         {
 | |
|           PowerBI: [
 | |
|             "docs/quick-ingestion-guides/powerbi/overview",
 | |
|             "docs/quick-ingestion-guides/powerbi/setup",
 | |
|             "docs/quick-ingestion-guides/powerbi/configuration",
 | |
|           ],
 | |
|         },
 | |
|         {
 | |
|           Looker: [
 | |
|             "docs/quick-ingestion-guides/looker/overview",
 | |
|             "docs/quick-ingestion-guides/looker/setup",
 | |
|             "docs/quick-ingestion-guides/looker/configuration",
 | |
|           ],
 | |
|         },
 | |
|       ],
 | |
|     },
 | |
|     {
 | |
|       type: "category",
 | |
|       label: "Sources",
 | |
|       link: { type: "doc", id: "metadata-ingestion/source_overview" },
 | |
|       items: [
 | |
|         // collapse these; add push-based at top
 | |
|         {
 | |
|           type: "doc",
 | |
|           id: "docs/lineage/airflow",
 | |
|           label: "Airflow",
 | |
|         },
 | |
|         {
 | |
|           type: "doc",
 | |
|           id: "docs/lineage/dagster",
 | |
|           label: "Dagster",
 | |
|         },
 | |
|         {
 | |
|           type: "doc",
 | |
|           id: "docs/lineage/prefect",
 | |
|           label: "Prefect",
 | |
|         },
 | |
|         {
 | |
|           type: "doc",
 | |
|           id: "metadata-integration/java/acryl-spark-lineage/README",
 | |
|           label: "Spark",
 | |
|         },
 | |
|         //"docker/airflow/local_airflow",
 | |
|         "metadata-ingestion/integration_docs/great-expectations",
 | |
|         "metadata-integration/java/datahub-protobuf/README",
 | |
|         //"metadata-integration/java/spark-lineage-legacy/README",
 | |
|         //"metadata-ingestion/source-docs-template",
 | |
|         {
 | |
|           type: "autogenerated",
 | |
|           dirName: "docs/generated/ingestion/sources", // '.' means the current docs folder
 | |
|         },
 | |
|       ],
 | |
|     },
 | |
|     {
 | |
|       "Advanced Guides": [
 | |
|         {
 | |
|           "Scheduling Ingestion": [
 | |
|             "metadata-ingestion/schedule_docs/intro",
 | |
|             "metadata-ingestion/schedule_docs/cron",
 | |
|             "metadata-ingestion/schedule_docs/airflow",
 | |
|             "metadata-ingestion/schedule_docs/kubernetes",
 | |
|           ],
 | |
|         },
 | |
| 
 | |
|         "docs/platform-instances",
 | |
|         "docs/lineage/sql_parsing",
 | |
|         "metadata-ingestion/docs/dev_guides/stateful",
 | |
|         "metadata-ingestion/docs/dev_guides/classification",
 | |
|         "metadata-ingestion/docs/dev_guides/add_stateful_ingestion_to_source",
 | |
|         "metadata-ingestion/docs/dev_guides/sql_profiles",
 | |
|         "metadata-ingestion/docs/dev_guides/profiling_ingestions",
 | |
|       ],
 | |
|     },
 | |
|     // APIs & SDKs.
 | |
|     {
 | |
|       type: "html",
 | |
|       value: "<div>API & SDKs</div>",
 | |
|       defaultStyle: true,
 | |
|     },
 | |
|     {
 | |
|       type: "category",
 | |
|       label: "Open Source DataHub Metadata Standard",
 | |
|       collapsed: false,
 | |
|       items: [
 | |
|         {
 | |
|           type: "doc",
 | |
|           label: "The Metadata Model",
 | |
|           id: "docs/modeling/metadata-model",
 | |
|         },
 | |
|         {
 | |
|           type: "doc",
 | |
|           label: "Core Metadata Events",
 | |
|           id: "docs/what/mxe",
 | |
|         },
 | |
|         {
 | |
|           type: "category",
 | |
|           label: "Entity Docs",
 | |
|           items: [
 | |
|             {
 | |
|               type: "autogenerated",
 | |
|               dirName: "docs/generated/metamodel/entities",
 | |
|             },
 | |
|           ],
 | |
|         },
 | |
|       ],
 | |
|     },
 | |
|     "docs/what-is-datahub/datahub-concepts",
 | |
|     {
 | |
|       type: "category",
 | |
|       label: "Metadata Standards",
 | |
|       link: { type: "doc", id: "docs/metadata-standards" },
 | |
|       items: [
 | |
|         {
 | |
|           type: "doc",
 | |
|           id: "docs/iceberg-catalog",
 | |
|         },
 | |
|         {
 | |
|           type: "doc",
 | |
|           id: "docs/lineage/openlineage",
 | |
|           label: "OpenLineage",
 | |
|         },
 | |
|       ],
 | |
|     },
 | |
|     {
 | |
|       type: "doc",
 | |
|       id: "docs/api/datahub-apis",
 | |
|       label: "Overview",
 | |
|     },
 | |
|     {
 | |
|       type: "category",
 | |
|       label: "API",
 | |
|       items: [
 | |
|         {
 | |
|           "GraphQL API": [
 | |
|             {
 | |
|               label: "Overview",
 | |
|               type: "doc",
 | |
|               id: "docs/api/graphql/overview",
 | |
|             },
 | |
|             {
 | |
|               Reference: [
 | |
|                 {
 | |
|                   type: "doc",
 | |
|                   label: "Queries",
 | |
|                   id: "graphql/queries",
 | |
|                 },
 | |
|                 {
 | |
|                   type: "doc",
 | |
|                   label: "Mutations",
 | |
|                   id: "graphql/mutations",
 | |
|                 },
 | |
|                 {
 | |
|                   type: "doc",
 | |
|                   label: "Objects",
 | |
|                   id: "graphql/objects",
 | |
|                 },
 | |
|                 {
 | |
|                   type: "doc",
 | |
|                   label: "Inputs",
 | |
|                   id: "graphql/inputObjects",
 | |
|                 },
 | |
|                 {
 | |
|                   type: "doc",
 | |
|                   label: "Interfaces",
 | |
|                   id: "graphql/interfaces",
 | |
|                 },
 | |
|                 {
 | |
|                   type: "doc",
 | |
|                   label: "Unions",
 | |
|                   id: "graphql/unions",
 | |
|                 },
 | |
|                 {
 | |
|                   type: "doc",
 | |
|                   label: "Enums",
 | |
|                   id: "graphql/enums",
 | |
|                 },
 | |
|                 {
 | |
|                   type: "doc",
 | |
|                   label: "Scalars",
 | |
|                   id: "graphql/scalars",
 | |
|                 },
 | |
|               ],
 | |
|             },
 | |
|             {
 | |
|               Guides: [
 | |
|                 {
 | |
|                   type: "doc",
 | |
|                   label: "How To Set Up GraphQL",
 | |
|                   id: "docs/api/graphql/how-to-set-up-graphql",
 | |
|                 },
 | |
|                 {
 | |
|                   type: "doc",
 | |
|                   label: "Getting Started With GraphQL",
 | |
|                   id: "docs/api/graphql/getting-started",
 | |
|                 },
 | |
|                 {
 | |
|                   type: "doc",
 | |
|                   label: "GraphQL Best Practices",
 | |
|                   id: "docs/api/graphql/graphql-best-practices",
 | |
|                 },
 | |
|                 {
 | |
|                   type: "doc",
 | |
|                   label: "Access Token Management",
 | |
|                   id: "docs/api/graphql/token-management",
 | |
|                 },
 | |
|               ],
 | |
|             },
 | |
|           ],
 | |
|         },
 | |
|         {
 | |
|           OpenAPI: [
 | |
|             {
 | |
|               type: "doc",
 | |
|               label: "OpenAPI",
 | |
|               id: "docs/api/openapi/openapi-usage-guide",
 | |
|             },
 | |
|           ],
 | |
|         },
 | |
|         "docs/dev-guides/timeline",
 | |
|         {
 | |
|           "Rest.li API": [
 | |
|             {
 | |
|               type: "doc",
 | |
|               label: "Rest.li API Guide",
 | |
|               id: "docs/api/restli/restli-overview",
 | |
|             },
 | |
|             {
 | |
|               type: "doc",
 | |
|               label: "Restore Indices",
 | |
|               id: "docs/api/restli/restore-indices",
 | |
|             },
 | |
|             {
 | |
|               type: "doc",
 | |
|               label: "Get Index Sizes",
 | |
|               id: "docs/api/restli/get-index-sizes",
 | |
|             },
 | |
|             {
 | |
|               type: "doc",
 | |
|               label: "Truncate Timeseries Aspect",
 | |
|               id: "docs/api/restli/truncate-time-series-aspect",
 | |
|             },
 | |
|             {
 | |
|               type: "doc",
 | |
|               label: "Get ElasticSearch Task Status Endpoint",
 | |
|               id: "docs/api/restli/get-elastic-task-status",
 | |
|             },
 | |
|             {
 | |
|               type: "doc",
 | |
|               label: "Evaluate Tests",
 | |
|               id: "docs/api/restli/evaluate-tests",
 | |
|             },
 | |
|             {
 | |
|               type: "doc",
 | |
|               label: "Aspect Versioning and Rest.li Modeling",
 | |
|               id: "docs/advanced/aspect-versioning",
 | |
|             },
 | |
|           ],
 | |
|         },
 | |
|       ],
 | |
|     },
 | |
|     {
 | |
|       type: "category",
 | |
|       label: "Python SDK",
 | |
|       items: [
 | |
|         "metadata-ingestion/as-a-library",
 | |
|         {
 | |
|           type: "category",
 | |
|           label: "SDK Reference",
 | |
|           items: [
 | |
|             {
 | |
|               type: "category",
 | |
|               label: "Builder",
 | |
|               items: [{ type: "autogenerated", dirName: "python-sdk/builder" }],
 | |
|             },
 | |
|             {
 | |
|               type: "category",
 | |
|               label: "Clients",
 | |
|               items: [{ type: "autogenerated", dirName: "python-sdk/clients" }],
 | |
|             },
 | |
|             {
 | |
|               type: "category",
 | |
|               label: "SDK V2",
 | |
|               items: [{ type: "autogenerated", dirName: "python-sdk/sdk-v2" }],
 | |
|             },
 | |
|             "python-sdk/models",
 | |
|             "python-sdk/urns",
 | |
|           ],
 | |
|         },
 | |
|       ],
 | |
|     },
 | |
|     {
 | |
|       type: "doc",
 | |
|       label: "Java SDK",
 | |
|       id: "metadata-integration/java/as-a-library",
 | |
|     },
 | |
|     {
 | |
|       type: "category",
 | |
|       label: "DataHub CLI",
 | |
|       link: { type: "doc", id: "docs/cli" },
 | |
|       items: ["docs/cli-commands/dataset", "docs/datahub_lite"],
 | |
|     },
 | |
|     {
 | |
|       type: "category",
 | |
|       label: "DataHub Actions",
 | |
|       link: { type: "doc", id: "docs/act-on-metadata" },
 | |
|       items: [
 | |
|         "docs/actions/README",
 | |
|         "docs/actions/quickstart",
 | |
|         "docs/actions/concepts",
 | |
|         {
 | |
|           Sources: [
 | |
|             {
 | |
|               type: "autogenerated",
 | |
|               dirName: "docs/actions/sources",
 | |
|             },
 | |
|           ],
 | |
|         },
 | |
|         {
 | |
|           Events: [
 | |
|             {
 | |
|               type: "autogenerated",
 | |
|               dirName: "docs/actions/events",
 | |
|             },
 | |
|           ],
 | |
|         },
 | |
|         {
 | |
|           Actions: [
 | |
|             {
 | |
|               type: "autogenerated",
 | |
|               dirName: "docs/actions/actions",
 | |
|             },
 | |
|           ],
 | |
|         },
 | |
|         {
 | |
|           Guides: [
 | |
|             {
 | |
|               type: "autogenerated",
 | |
|               dirName: "docs/actions/guides",
 | |
|             },
 | |
|           ],
 | |
|         },
 | |
|       ],
 | |
|     },
 | |
|     {
 | |
|       Guides: [
 | |
|         "docs/api/tutorials/datasets",
 | |
|         "docs/api/tutorials/deprecation",
 | |
|         "docs/api/tutorials/descriptions",
 | |
|         "docs/api/tutorials/custom-properties",
 | |
|         "docs/api/tutorials/assertions",
 | |
|         "docs/api/tutorials/custom-assertions",
 | |
|         "docs/api/tutorials/sdk/bulk-assertions-sdk",
 | |
|         "docs/api/tutorials/incidents",
 | |
|         "docs/api/tutorials/operations",
 | |
|         "docs/api/tutorials/data-contracts",
 | |
|         "docs/api/tutorials/domains",
 | |
|         "docs/api/tutorials/forms",
 | |
|         "docs/api/tutorials/lineage",
 | |
|         "docs/api/tutorials/container",
 | |
|         "docs/api/tutorials/dashboard-chart",
 | |
|         "docs/api/tutorials/dataflow-datajob",
 | |
|         "docs/api/tutorials/mlmodel-mlmodelgroup",
 | |
|         "docs/api/tutorials/applications",
 | |
|         {
 | |
|           type: "doc",
 | |
|           id: "docs/api/tutorials/ml",
 | |
|           label: "AI/ML Integration",
 | |
|         },
 | |
|         {
 | |
|           type: "doc",
 | |
|           id: "docs/api/tutorials/ml_feature_store",
 | |
|           label: "Feature Store",
 | |
|         },
 | |
|         "docs/api/tutorials/owners",
 | |
|         "docs/api/tutorials/structured-properties",
 | |
|         "docs/api/tutorials/subscriptions",
 | |
|         "docs/api/tutorials/tags",
 | |
|         "docs/api/tutorials/terms",
 | |
|         {
 | |
|           type: "doc",
 | |
|           id: "docs/advanced/patch",
 | |
|           label: "Patch",
 | |
|         },
 | |
|         "docs/api/tutorials/sdk/search_client",
 | |
|       ],
 | |
|     },
 | |
|     // Admin.
 | |
|     {
 | |
|       type: "html",
 | |
|       value: "<div>Admin</div>",
 | |
|       defaultStyle: true,
 | |
|     },
 | |
|     {
 | |
|       Authentication: [
 | |
|         "docs/authentication/README",
 | |
|         "docs/authentication/concepts",
 | |
|         "docs/authentication/changing-default-credentials",
 | |
|         "docs/authentication/guides/add-users",
 | |
|         {
 | |
|           "Frontend Authentication": [
 | |
|             "docs/authentication/guides/jaas",
 | |
|             "docs/authentication/guides/sso/initialize-oidc",
 | |
|             "docs/authentication/guides/sso/configure-oidc-react",
 | |
|             "docs/authentication/guides/sso/configure-oidc-behind-proxy",
 | |
|           ],
 | |
|         },
 | |
|         "docs/authentication/introducing-metadata-service-authentication",
 | |
|         "docs/authentication/personal-access-tokens",
 | |
|         "docs/authentication/external-oauth-providers",
 | |
|       ],
 | |
|     },
 | |
|     {
 | |
|       Authorization: [
 | |
|         "docs/authorization/README",
 | |
|         "docs/authorization/roles",
 | |
|         "docs/authorization/policies",
 | |
|         "docs/authorization/groups",
 | |
|       ],
 | |
|     },
 | |
|     {
 | |
|       "Advanced Guides": [
 | |
|         "docs/how/delete-metadata",
 | |
|         "docs/how/configuring-authorization-with-apache-ranger",
 | |
|         {
 | |
|           "SCIM Provisioning": [
 | |
|             "docs/managed-datahub/configuring-identity-provisioning-with-ms-entra",
 | |
|             "docs/managed-datahub/configuring-identity-provisioning-with-okta",
 | |
|           ],
 | |
|         },
 | |
|         "docs/how/backup-datahub",
 | |
|         "docs/how/restore-indices",
 | |
|         "docs/how/load-indices",
 | |
|         "docs/advanced/db-retention",
 | |
|         "docs/advanced/monitoring",
 | |
|         "docs/deploy/telemetry",
 | |
|         "docs/how/kafka-config",
 | |
|         "docs/how/configure-cdc",
 | |
|         "docs/how/jattach-guide",
 | |
|       ],
 | |
|     },
 | |
|     // Deployment.
 | |
|     {
 | |
|       type: "html",
 | |
|       value: "<div>Deployment</div>",
 | |
|       defaultStyle: true,
 | |
|     },
 | |
|     {
 | |
|       type: "category",
 | |
|       label: "Deployment Guides",
 | |
|       link: {
 | |
|         type: "generated-index",
 | |
|         title: "Deployment Guides",
 | |
|         description:
 | |
|           "Learn how to deploy DataHub to your environment, set up authentication, manage upgrades, and more.",
 | |
|       },
 | |
|       items: [
 | |
|         "docs/deploy/aws",
 | |
|         "docs/deploy/gcp",
 | |
|         "docs/deploy/azure",
 | |
|         "docker/README",
 | |
|         "docs/deploy/kubernetes",
 | |
|       ],
 | |
|     },
 | |
|     {
 | |
|       type: "category",
 | |
|       label: "Advanced Guides",
 | |
|       items: [
 | |
|         "docs/deploy/confluent-cloud",
 | |
|         "docs/deploy/environment-vars",
 | |
|         "docs/how/extract-container-logs",
 | |
|       ],
 | |
|     },
 | |
|     // Developers.
 | |
|     {
 | |
|       type: "html",
 | |
|       value: "<div>Developers</div>",
 | |
|       defaultStyle: true,
 | |
|     },
 | |
|     {
 | |
|       Architecture: [
 | |
|         "docs/architecture/architecture",
 | |
|         "docs/components",
 | |
|         "docs/architecture/metadata-ingestion",
 | |
|         "docs/architecture/metadata-serving",
 | |
|         "docs/architecture/docker-containers",
 | |
|       ],
 | |
|     },
 | |
|     {
 | |
|       "Developing on DataHub": [
 | |
|         "docs/developers",
 | |
|         "docs/docker/development",
 | |
|         "metadata-ingestion/developing",
 | |
|         "docs/api/graphql/graphql-endpoint-development",
 | |
|         {
 | |
|           Modules: [
 | |
|             "datahub-web-react/README",
 | |
|             "datahub-frontend/README",
 | |
|             "datahub-graphql-core/README",
 | |
|             "metadata-service/README",
 | |
|             "metadata-jobs/mae-consumer-job/README",
 | |
|             "metadata-jobs/mce-consumer-job/README",
 | |
|           ],
 | |
|         },
 | |
|         {
 | |
|           Troubleshooting: [
 | |
|             "docs/troubleshooting/quickstart",
 | |
|             "docs/troubleshooting/build",
 | |
|             "docs/troubleshooting/general",
 | |
|           ],
 | |
|         },
 | |
|       ],
 | |
|     },
 | |
|     {
 | |
|       "Advanced Guides": [
 | |
|         "docs/advanced/mcp-mcl",
 | |
|         "docs/advanced/writing-mcps",
 | |
|         "docs/modeling/extending-the-metadata-model",
 | |
|         "docs/advanced/api-tracing",
 | |
|         "datahub-web-react/src/app/analytics/README",
 | |
|         "docker/datahub-upgrade/README",
 | |
|         "metadata-ingestion/adding-source",
 | |
|         "docs/how/add-custom-ingestion-source",
 | |
|         "docs/how/add-custom-data-platform",
 | |
|         "docs/how/migrating-graph-service-implementation",
 | |
|         "docs/advanced/field-path-spec-v2",
 | |
|         "docs/advanced/browse-paths-upgrade",
 | |
|         "docs/browseV2/browse-paths-v2",
 | |
|         "metadata-ingestion/docs/dev_guides/reporting_telemetry",
 | |
|         "docs/plugins",
 | |
|         "docs/advanced/bootstrap-mcps",
 | |
|       ],
 | |
|     },
 | |
|     // Community.
 | |
|     {
 | |
|       type: "html",
 | |
|       value: "<div>Community</div>",
 | |
|       defaultStyle: true,
 | |
|     },
 | |
|     {
 | |
|       label: "Community",
 | |
|       type: "category",
 | |
|       collapsed: true,
 | |
|       link: {
 | |
|         type: "generated-index",
 | |
|         title: "Community",
 | |
|         description: "Learn about DataHub community.",
 | |
|       },
 | |
|       items: [
 | |
|         "docs/slack",
 | |
|         "docs/townhalls",
 | |
|         //        "docs/townhall-history",
 | |
|         "docs/CODE_OF_CONDUCT",
 | |
|         "docs/CONTRIBUTING",
 | |
|         "docs/links",
 | |
|         "docs/rfc",
 | |
|         "SECURITY",
 | |
|       ],
 | |
|     },
 | |
|     {
 | |
|       "Release History": ["releases", "docs/how/updating-datahub"],
 | |
|     },
 | |
| 
 | |
|     // "Candidates for Deprecation": [
 | |
|     // "README",
 | |
|     // "docs/roadmap",
 | |
|     // "docs/advanced/backfilling",
 | |
|     //"docs/advanced/derived-aspects",
 | |
|     //"docs/advanced/entity-hierarchy",
 | |
|     //"docs/advanced/partial-update",
 | |
|     //"docs/advanced/pdl-best-practices",
 | |
|     //"docs/introducing-metadata-service-authentication"
 | |
|     //"metadata-models-custom/README"
 | |
|     //"metadata-ingestion/examples/transforms/README"
 | |
|     //"docs/what/graph",
 | |
|     //"docs/what/search-index",
 | |
|     //"docs/how/add-new-aspect",
 | |
|     //"docs/how/build-metadata-service",
 | |
|     //"docs/how/graph-onboarding",
 | |
|     //"docs/demo/graph-onboarding",
 | |
|     //"datahub-actions/README",
 | |
|     //"datahub-actions/src/datahub_actions/plugin/action/tag/README",
 | |
|     //"datahub-actions/src/datahub_actions/plugin/action/term/README",
 | |
|     //"metadata-integration/java/spark-lineage/README",
 | |
|     // "metadata-integration/java/acryl-spark-lineage/README.md
 | |
|     // "metadata-integration/java/openlineage-converter/README"
 | |
|     //"metadata-ingestion-modules/airflow-plugin/README"
 | |
|     //"metadata-ingestion-modules/dagster-plugin/README"
 | |
|     //"metadata-ingestion-modules/prefect-plugin/README"
 | |
|     //"metadata-ingestion-modules/gx-plugin/README"
 | |
|     // "metadata-ingestion/schedule_docs/datahub", // we can delete this
 | |
|     // TODO: change the titles of these, removing the "What is..." portion from the sidebar"
 | |
|     // "docs/what/entity",
 | |
|     // "docs/what/aspect",
 | |
|     // "docs/what/urn",
 | |
|     // "docs/what/relationship",
 | |
|     // "docs/advanced/high-cardinality",
 | |
|     // "docs/what/search-document",
 | |
|     // "docs/what/snapshot",
 | |
|     // "docs/what/delta",
 | |
|     // - "docker/datahub-frontend/README",
 | |
|     // - "docker/datahub-gms/README",
 | |
|     // - "docker/datahub-mae-consumer/README",
 | |
|     // - "docker/datahub-mce-consumer/README",
 | |
|     // - "docker/datahub-ingestion/README",
 | |
|     // - "docker/elasticsearch-setup/README",
 | |
|     // - "docker/ingestion/README",
 | |
|     // - "docker/mariadb/README",
 | |
|     // - "docker/mysql/README",
 | |
|     // - "docker/neo4j/README",
 | |
|     // - "docker/postgres/README",
 | |
|     // - "perf-test/README",
 | |
|     // "metadata-jobs/README",
 | |
|     // "docs/how/add-user-data",
 | |
|     // "docs/_feature-guide-template"
 | |
|     // "docs/_api-guide-template"
 | |
|     // - "metadata-service/services/README"
 | |
|     // "metadata-ingestion/examples/structured_properties/README"
 | |
|     // "smoke-test/tests/openapi/README"
 | |
|     // "smoke-test/tests/cypress/README"
 | |
|     // "docs/SECURITY_STANCE"
 | |
|     // "metadata-integration/java/datahub-schematron/README"
 | |
|     // "smoke-test/tests/cypress/README"
 | |
|     // ],
 | |
|   ],
 | |
| };
 | 
