Skip to content

[DOCS-15447] De-duplicate remaining BI integration docs - #39739

Draft
evazorro wants to merge 1 commit into
masterfrom
eva/DOCS-15447-bi-integration-stubs
Draft

[DOCS-15447] De-duplicate remaining BI integration docs#39739
evazorro wants to merge 1 commit into
masterfrom
eva/DOCS-15447-bi-integration-stubs

Conversation

@evazorro

@evazorro evazorro commented Sep 4, 2026

Copy link
Copy Markdown
Contributor

What does this PR do? What is the motivation?

Fixes DOCS-15447

This is the follow-up to the Hex proof of concept, applied to the remaining five BI integrations: Looker, Tableau, Sigma, Power BI, and Metabase.

Each of these integrations has two copies of its docs — one under integrations/ generated from the integration README, and one under data_observability/. The two have drifted. This PR keeps the integrations/ version as the single source of truth and reduces each data_observability/ page to a stub: what the integration is for, the data warehouse prerequisite, and a link to the integration docs for setup.

  • Same stub format as Hex: title, description, one-line value proposition, warehouse prerequisite, link out
  • No nav changes needed this time. All five menu entries already point at these data_observability/ paths, and the pages still exist, so nothing breaks
  • Metabase's stub differs on purpose. It's the only one of the six that also does log collection, which doesn't depend on a warehouse, so its prerequisite sentence is scoped to lineage

Merge readiness

  • Ready for merge

For Datadog employees:

  • ⚠️ Your branch name MUST follow the <name>/<description> convention and include the forward slash (/). If you've already created your PR with an incorrect branch name, please rename your branch and open a fresh PR.
  • 🤖 New: Comment with /review to run an automated check that catches common issues before a Documentation team member reviews your PR.

AI assistance

Used Claude Code to diff each pair of docs, identify what content existed only in the Data Observability copy, and draft the stubs. Information architecture decisions, the Metabase scoping call, and this description by me.

Additional notes

Companion PRs move the content that only existed in the Data Observability copies into the integration READMEs:

Note that hugo/data/partials/platforms.yaml has an unrelated local change in my working tree that is deliberately not included here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant