[WIP] Add Hex integration documentation#37960
Draft
kevinzenghu wants to merge 2 commits into
Draft
Conversation
Hex has been GA (per the DO Product Features tracker) with zero public documentation. Grounded in domains/data_observability/apps/apis/ data-observability-crawler/internal/crawlers/hex/ (hex_client.go, hex_crawler.go, models.go) and the hex.json connection schema. Follows the same structure as the sibling Metabase/Looker/PowerBI pages. Explicitly notes the one real limitation found in code: Databricks and Postgres data-connection lineage is incomplete (TODO comments in models.go) even though Snowflake and BigQuery are fully supported — included so the docs don't overclaim. AI assistance: drafted by Claude Code, grounded in the cited crawler source and connection schema.
Contributor
Preview links (active after the
|
Same class of bug just found and fixed for Airbyte: this PR's new content/en/.../business_intelligence/hex.md page and its elt-equivalent whatsnext link were correctly added, but config/_default/menus/main.en.yaml (the separate file that drives the actual sidebar) was not — this branch predates discovering that file exists. Added the missing entry, weighted to sort after the existing four BI integrations.
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.
Summary
Evidence
data-observability-crawler/internal/crawlers/hex/(hex_client.go, hex_crawler.go, models.go) — auth method, discovered entities, sync interval.hex.json— exact field names/descriptions for the integration tile.Open items
Status
Work in progress — not ready for review yet. Draft, no reviewers requested.
AI assistance
Content drafted by Claude Code, grounded in the cited crawler source and connection schema — flagging per the AI-assistance disclosure in CONTRIBUTING.md.