docs(managed-datahub): restructure OSS vs Cloud comparison guide - #19110
Open
lakshay-nasa wants to merge 2 commits into
Open
docs(managed-datahub): restructure OSS vs Cloud comparison guide#19110lakshay-nasa wants to merge 2 commits into
lakshay-nasa wants to merge 2 commits into
Conversation
github-actions
Bot
added
docs
![cubic-dev-ai[bot]](https://avatars.githubusercontent.com/in/1082092?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
5 issues found across 1 file
Prompt for AI agents (unresolved issues)
Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.
<file name="docs/managed-datahub/managed-datahub-overview.md">
<violation number="1" location="docs/managed-datahub/managed-datahub-overview.md:49">
P2: Cloud availability is overstated for several gated features: Scoped MCP Servers, Ask DataHub Plugins, and the Data Observability Agent are Private Beta rather than generally available to Cloud customers. Consider labeling beta availability consistently so readers do not interpret each ✔ as included access.</violation>
<violation number="2" location="docs/managed-datahub/managed-datahub-overview.md:52">
P2: The comparison incorrectly excludes OSS from the named Claude surface even though the linked Claude guide supports self-hosted DataHub. Consider splitting surfaces by availability or marking the row as supported in OSS and Cloud.</violation>
<violation number="3" location="docs/managed-datahub/managed-datahub-overview.md:68">
P2: The comparison makes GitHub Context Document import look unavailable in OSS, although the linked guide explicitly documents the open-source `github-documents` importer and limits only sync-back to Cloud. Marking import available in both columns and qualifying PR sync-back as Cloud-only would preserve the actual distinction.</violation>
<violation number="4" location="docs/managed-datahub/managed-datahub-overview.md:70">
P2: OSS users are incorrectly told that the Logical Models UI is Cloud-only. The linked guide documents creating and editing logical models in the UI when `LOGICAL_MODELS_ENABLED` is set on `datahub-gms`; only Centralized Management is identified as the Cloud enhancement. This row should mark the UI as available in OSS (or narrow the feature name to the specific Cloud-only capability).</violation>
<violation number="5" location="docs/managed-datahub/managed-datahub-overview.md:119">
P3: The language statuses conflict with the linked canonical guide, which calls these translations Beta rather than Private Beta. Using the same `Beta` label avoids incorrectly implying access is gated.</violation>
</file>
Tip: instead of fixing issues one by one fix them all with cubic
Re-trigger cubic
| | **Scoped MCP Servers** | ❌ | ✔ | Create purpose-built MCP servers with curated tools and scoped access to specific data assets and context documents | [Docs](https://docs.datahub.com/docs/features/feature-guides/scoped-mcp-servers) | | ||
| | **Skills Library (Ask DataHub, SQL grounding, lineage lookup)** | ✔ | ✔ | Pre-built skills for accurate SQL generation and data discovery | [Docs](https://docs.datahub.com/docs/dev-guides/agent-context/skills) | | ||
| | **Full API & SDK** | ✔ | ✔ | Integrate DataHub context into any custom agent or workflow | [Docs](https://docs.datahub.com/docs/dev-guides/agent-context/agent-context) | | ||
| | **Native Agent Surfaces (Claude, Snowflake, Databricks, etc.)** | ❌ | ✔ | Surface verified context inside the tools your team already uses | [Docs](https://docs.datahub.com/docs/dev-guides/agent-context/claude) | |
Contributor
There was a problem hiding this comment.
P2: The comparison incorrectly excludes OSS from the named Claude surface even though the linked Claude guide supports self-hosted DataHub. Consider splitting surfaces by availability or marking the row as supported in OSS and Cloud.
Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At docs/managed-datahub/managed-datahub-overview.md, line 52:
<comment>The comparison incorrectly excludes OSS from the named Claude surface even though the linked Claude guide supports self-hosted DataHub. Consider splitting surfaces by availability or marking the row as supported in OSS and Cloud.</comment>
<file context>
@@ -7,34 +7,85 @@ description: "Compare DataHub Open Source and DataHub Cloud, covering enterprise
+| **Scoped MCP Servers** | ❌ | ✔ | Create purpose-built MCP servers with curated tools and scoped access to specific data assets and context documents | [Docs](https://docs.datahub.com/docs/features/feature-guides/scoped-mcp-servers) |
+| **Skills Library (Ask DataHub, SQL grounding, lineage lookup)** | ✔ | ✔ | Pre-built skills for accurate SQL generation and data discovery | [Docs](https://docs.datahub.com/docs/dev-guides/agent-context/skills) |
+| **Full API & SDK** | ✔ | ✔ | Integrate DataHub context into any custom agent or workflow | [Docs](https://docs.datahub.com/docs/dev-guides/agent-context/agent-context) |
+| **Native Agent Surfaces (Claude, Snowflake, Databricks, etc.)** | ❌ | ✔ | Surface verified context inside the tools your team already uses | [Docs](https://docs.datahub.com/docs/dev-guides/agent-context/claude) |
+| **Ask DataHub AI Agent + Plugins** | ❌ | ✔ | Find trustworthy metrics, generate accurate SQL, debug data quality issues, understand data impact | [Docs](https://docs.datahub.com/docs/features/feature-guides/ask-datahub) |
+
</file context>
| @@ -7,34 +7,85 @@ description: "Compare DataHub Open Source and DataHub Cloud, covering enterprise | |||
|
|
|||
Contributor
There was a problem hiding this comment.
P2: Cloud availability is overstated for several gated features: Scoped MCP Servers, Ask DataHub Plugins, and the Data Observability Agent are Private Beta rather than generally available to Cloud customers. Consider labeling beta availability consistently so readers do not interpret each ✔ as included access.
Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At docs/managed-datahub/managed-datahub-overview.md, line 49:
<comment>Cloud availability is overstated for several gated features: Scoped MCP Servers, Ask DataHub Plugins, and the Data Observability Agent are Private Beta rather than generally available to Cloud customers. Consider labeling beta availability consistently so readers do not interpret each ✔ as included access.</comment>
<file context>
@@ -7,34 +7,85 @@ description: "Compare DataHub Open Source and DataHub Cloud, covering enterprise
+| Feature Name | OSS | Cloud | Business Value | Link |
+| :-------------------------------------------------------------- | :-: | :---: | :------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------: |
+| **DataHub Hosted MCP Server** | ❌ | ✔ | Connect AI tools directly to your data catalog | [Docs](https://docs.datahub.com/docs/features/feature-guides/mcp) |
+| **Scoped MCP Servers** | ❌ | ✔ | Create purpose-built MCP servers with curated tools and scoped access to specific data assets and context documents | [Docs](https://docs.datahub.com/docs/features/feature-guides/scoped-mcp-servers) |
+| **Skills Library (Ask DataHub, SQL grounding, lineage lookup)** | ✔ | ✔ | Pre-built skills for accurate SQL generation and data discovery | [Docs](https://docs.datahub.com/docs/dev-guides/agent-context/skills) |
+| **Full API & SDK** | ✔ | ✔ | Integrate DataHub context into any custom agent or workflow | [Docs](https://docs.datahub.com/docs/dev-guides/agent-context/agent-context) |
</file context>
| | **Column-Level Lineage & Impact Analysis** | ✔ | ✔ | Understand data dependencies | [Docs](https://docs.datahub.com/docs/features/feature-guides/lineage) | | ||
| | **Lineage-Based Propagation** | ❌ | ✔ | Auto-enrich downstream datasets | [Docs](https://docs.datahub.com/docs/automations/docs-propagation#introduction) | | ||
| | **Context Documents** | ✔ | ✔ | Create & semantically search across unstructured docs | [Docs](https://docs.datahub.com/docs/features/feature-guides/context/context-documents) | | ||
| | **Import Context Documents from GitHub** | ❌ | ✔ | Import GitHub repositories as semantically-searchable context documents, editable in DataHub and synced back via PRs | [Docs](https://docs.datahub.com/docs/features/feature-guides/context/context-documents#importing-documents) | |
Contributor
There was a problem hiding this comment.
P2: The comparison makes GitHub Context Document import look unavailable in OSS, although the linked guide explicitly documents the open-source github-documents importer and limits only sync-back to Cloud. Marking import available in both columns and qualifying PR sync-back as Cloud-only would preserve the actual distinction.
Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At docs/managed-datahub/managed-datahub-overview.md, line 68:
<comment>The comparison makes GitHub Context Document import look unavailable in OSS, although the linked guide explicitly documents the open-source `github-documents` importer and limits only sync-back to Cloud. Marking import available in both columns and qualifying PR sync-back as Cloud-only would preserve the actual distinction.</comment>
<file context>
@@ -7,34 +7,85 @@ description: "Compare DataHub Open Source and DataHub Cloud, covering enterprise
+| **Column-Level Lineage & Impact Analysis** | ✔ | ✔ | Understand data dependencies | [Docs](https://docs.datahub.com/docs/features/feature-guides/lineage) |
+| **Lineage-Based Propagation** | ❌ | ✔ | Auto-enrich downstream datasets | [Docs](https://docs.datahub.com/docs/automations/docs-propagation#introduction) |
+| **Context Documents** | ✔ | ✔ | Create & semantically search across unstructured docs | [Docs](https://docs.datahub.com/docs/features/feature-guides/context/context-documents) |
+| **Import Context Documents from GitHub** | ❌ | ✔ | Import GitHub repositories as semantically-searchable context documents, editable in DataHub and synced back via PRs | [Docs](https://docs.datahub.com/docs/features/feature-guides/context/context-documents#importing-documents) |
+| **AI Documentation Generation** | ❌ | ✔ | Auto-document tables & columns | [Docs](https://docs.datahub.com/docs/automations/ai-docs) |
+| **Logical Models UI** | ❌ | ✔ | Create and manage logical models from the UI without API or SDK access | [Docs](https://docs.datahub.com/docs/features/feature-guides/logical-models/overview) |
</file context>
Suggested change
| | **Import Context Documents from GitHub** | ❌ | ✔ | Import GitHub repositories as semantically-searchable context documents, editable in DataHub and synced back via PRs | [Docs](https://docs.datahub.com/docs/features/feature-guides/context/context-documents#importing-documents) | | |
| | **Import Context Documents from GitHub** | ✔ | ✔ | Import GitHub repositories as semantically-searchable context documents; DataHub Cloud can sync edits back via PRs | [Docs](https://docs.datahub.com/docs/features/feature-guides/context/context-documents#importing-documents) | |
| | **Context Documents** | ✔ | ✔ | Create & semantically search across unstructured docs | [Docs](https://docs.datahub.com/docs/features/feature-guides/context/context-documents) | | ||
| | **Import Context Documents from GitHub** | ❌ | ✔ | Import GitHub repositories as semantically-searchable context documents, editable in DataHub and synced back via PRs | [Docs](https://docs.datahub.com/docs/features/feature-guides/context/context-documents#importing-documents) | | ||
| | **AI Documentation Generation** | ❌ | ✔ | Auto-document tables & columns | [Docs](https://docs.datahub.com/docs/automations/ai-docs) | | ||
| | **Logical Models UI** | ❌ | ✔ | Create and manage logical models from the UI without API or SDK access | [Docs](https://docs.datahub.com/docs/features/feature-guides/logical-models/overview) | |
Contributor
There was a problem hiding this comment.
P2: OSS users are incorrectly told that the Logical Models UI is Cloud-only. The linked guide documents creating and editing logical models in the UI when LOGICAL_MODELS_ENABLED is set on datahub-gms; only Centralized Management is identified as the Cloud enhancement. This row should mark the UI as available in OSS (or narrow the feature name to the specific Cloud-only capability).
Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At docs/managed-datahub/managed-datahub-overview.md, line 70:
<comment>OSS users are incorrectly told that the Logical Models UI is Cloud-only. The linked guide documents creating and editing logical models in the UI when `LOGICAL_MODELS_ENABLED` is set on `datahub-gms`; only Centralized Management is identified as the Cloud enhancement. This row should mark the UI as available in OSS (or narrow the feature name to the specific Cloud-only capability).</comment>
<file context>
@@ -7,34 +7,85 @@ description: "Compare DataHub Open Source and DataHub Cloud, covering enterprise
+| **Context Documents** | ✔ | ✔ | Create & semantically search across unstructured docs | [Docs](https://docs.datahub.com/docs/features/feature-guides/context/context-documents) |
+| **Import Context Documents from GitHub** | ❌ | ✔ | Import GitHub repositories as semantically-searchable context documents, editable in DataHub and synced back via PRs | [Docs](https://docs.datahub.com/docs/features/feature-guides/context/context-documents#importing-documents) |
+| **AI Documentation Generation** | ❌ | ✔ | Auto-document tables & columns | [Docs](https://docs.datahub.com/docs/automations/ai-docs) |
+| **Logical Models UI** | ❌ | ✔ | Create and manage logical models from the UI without API or SDK access | [Docs](https://docs.datahub.com/docs/features/feature-guides/logical-models/overview) |
+| **Personalized Home and Asset Views** | ❌ | ✔ | Customize home page and asset summaries for a personalized data experience | [Docs](https://docs.datahub.com/docs/features/feature-guides/custom-asset-summaries#custom-modules) |
+| **Multi-Channel Notifications** | ❌ | ✔ | Stay informed where you work (Email, Slack, & Teams) | [Docs](https://docs.datahub.com/docs/incidents/incidents/#enabling-slack-notifications-datahub-cloud-only) |
</file context>
Suggested change
| | **Logical Models UI** | ❌ | ✔ | Create and manage logical models from the UI without API or SDK access | [Docs](https://docs.datahub.com/docs/features/feature-guides/logical-models/overview) | | |
| | **Logical Models UI** | ✔ | ✔ | Create and manage logical models from the UI without API or SDK access | [Docs](https://docs.datahub.com/docs/features/feature-guides/logical-models/overview) | |
| | **Fully Managed Cloud Deployment** | ❌ | ✔ | Zero maintenance cloud-hosted instance | | ||
| | **Dedicated Customer Success** | ❌ | ✔ | Expert guidance | | ||
| | **Guided Implementation & Onboarding** | ❌ | ✔ | Smooth rollout | | ||
| | **[Multi-language Support](https://docs.datahub.com/docs/features/feature-guides/multi-language-support)** | ✔ | ✔ | Use DataHub in your browser's language: <br /> _GA:_ German <br /> _Private Beta:_ Spanish, Brazilian Portuguese, French, Italian, Norwegian, Swedish, Hungarian | |
Contributor
There was a problem hiding this comment.
P3: The language statuses conflict with the linked canonical guide, which calls these translations Beta rather than Private Beta. Using the same Beta label avoids incorrectly implying access is gated.
Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At docs/managed-datahub/managed-datahub-overview.md, line 119:
<comment>The language statuses conflict with the linked canonical guide, which calls these translations Beta rather than Private Beta. Using the same `Beta` label avoids incorrectly implying access is gated.</comment>
<file context>
@@ -60,14 +111,15 @@ This guide compares DataHub Open Source (OSS) and DataHub Cloud features and pla
+| **Fully Managed Cloud Deployment** | ❌ | ✔ | Zero maintenance cloud-hosted instance |
+| **Dedicated Customer Success** | ❌ | ✔ | Expert guidance |
+| **Guided Implementation & Onboarding** | ❌ | ✔ | Smooth rollout |
+| **[Multi-language Support](https://docs.datahub.com/docs/features/feature-guides/multi-language-support)** | ✔ | ✔ | Use DataHub in your browser's language: <br /> _GA:_ German <br /> _Private Beta:_ Spanish, Brazilian Portuguese, French, Italian, Norwegian, Swedish, Hungarian |
+| **Private Slack Support Channel** | ❌ | ✔ | Direct access to experts |
+| **Community Support** | ✔ | ✔ | Peer assistance |
</file context>
Suggested change
| | **[Multi-language Support](https://docs.datahub.com/docs/features/feature-guides/multi-language-support)** | ✔ | ✔ | Use DataHub in your browser's language: <br /> _GA:_ German <br /> _Private Beta:_ Spanish, Brazilian Portuguese, French, Italian, Norwegian, Swedish, Hungarian | | |
| | **[Multi-language Support](https://docs.datahub.com/docs/features/feature-guides/multi-language-support)** | ✔ | ✔ | Use DataHub in your browser's language: <br /> _GA:_ German <br /> _Beta:_ Spanish, Brazilian Portuguese, French, Italian, Norwegian, Swedish, Hungarian | |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Refreshes the OSS vs Cloud comparison guide to reflect the current feature set.
Checklist
docs/how/updating-datahub.mdSummary by cubic
Restructures the OSS vs Cloud comparison guide to match the current feature set and make differences easier to scan. Adds a new Context Platform pillar and refreshes Discovery, Observability, and Support content with clearer availability and deep links.
Written for commit 248a0ea. Summary will update on new commits.