Skip to content

[WIP] Add Airbyte to the sidebar navigation#37966

Draft
kevinzenghu wants to merge 1 commit into
masterfrom
kevinzenghu/add-airbyte-to-sidebar-nav
Draft

[WIP] Add Airbyte to the sidebar navigation#37966
kevinzenghu wants to merge 1 commit into
masterfrom
kevinzenghu/add-airbyte-to-sidebar-nav

Conversation

@kevinzenghu

Copy link
Copy Markdown
Contributor

Summary

Airbyte's docs page has existed and been directly reachable since it went GA (2026-05-19), and is correctly cross-linked from the ELT Integrations landing page — but was never added to config/_default/menus/main.en.yaml, the separate file that drives the actual persistent left sidebar on docs.datadoghq.com. Fivetran has an entry there; Airbyte never did.

Root cause (for anyone hitting this pattern again)

The content tree's own internal cross-linking (whatsnext/nextlink/card-grid shortcodes) and the site's persistent sidebar nav are two separate mechanisms. A page can be fully live, GA, and correctly linked within the content tree while still being invisible in the sidebar if nobody added the corresponding entry to this menu config. Confirmed the same gap independently affects the pre-existing data_observability/cicd/ page (fixed in #37958) — worth an audit for other silent misses.

Status

Work in progress — not ready for review yet. Draft, no reviewers requested.

AI assistance

Root-caused and fixed by Claude Code after a user reported the sidebar discrepancy with a screenshot — flagging per the AI-assistance disclosure in CONTRIBUTING.md.

Airbyte's docs page (content/en/data_observability/quality_monitoring/
elt/airbyte.md) has existed and been reachable by direct URL since it
went GA (2026-05-19, per the #data-observability Slack GA announcement),
and it's correctly cross-linked from elt/_index.md's own "what's next"
grid. But it was never added to config/_default/menus/main.en.yaml —
the separate, manually-maintained file that actually drives the
persistent left sidebar nav on docs.datadoghq.com. Fivetran has an
entry there; Airbyte never did, which is why it's invisible in the
sidebar despite being live and GA.

Weighted to sort before Fivetran (500000 vs 1000000), matching the
order both already appear in on the ELT Integrations landing page.

AI assistance: found and fixed by Claude Code after a user noticed the
sidebar discrepancy directly; root-caused by comparing the content tree
against the separate menu config file.
@github-actions github-actions Bot added the Architecture Everything related to the Doc backend label Jul 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Architecture Everything related to the Doc backend

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant