De-duplicate Hex integration docs - #39211
Conversation
Preview links (active after the
|
|
Hi Eva! Apologies for not following up on the Slack thread, and thanks for picking this up. Agreed on deduplicating when the content is identical. My one ask is on direction: could we keep the DO doc as canonical and link out from The reason is that Hex, like most of our Business Intelligence integrations for Data Observability, doesn't do anything on its own. It has no standalone metrics or tile install. It depends on a warehouse like Snowflake being connected first to establish lineage. Someone landing on Longer term, if we can extract generally useful Datadog metrics from Hex, that would justify a broader integration page in addition to the DO content! |
What does this PR do? What is the motivation?
Right now there are two copies of the Hex integration docs:
I want to consolidate so that there's only a single doc for this integration. In my opinion, the best way to do this is to use the
integrations/version. But we can leave info about Hex in the Data Observability docs for discoverability, and just link from there to the integrations docs.This PR removes the content from the duplicate version, and sets up a few links and redirects to the integration docs.
Some technical details for the Docs team reviewer
external_redirect. There's precedent for doing this: see this old setup guide that now redirects to the main Oracle Fusion integration doc.Merge readiness
AI assistance
Used Claude Code to explore different options for restructuring and redirecting, and to make the nav changes. Information architecture, testing, and PR descriptions by me.
Additional notes
There's a corresponding PR in integrations-internal-core to make a couple updates to the Hex README. I may move some of the content I deleted here into that version, if the DO team wants.
Also
I am planning to repeat this process with the other duplicate integration docs under data_observability/quality_monitoring/, if everyone is on board after seeing this proof of concept.