Skip to content

Fix broken links - #1191

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/0fc6449e
Open

Fix broken links#1191
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/0fc6449e

Conversation

@mintlify

@mintlify mintlify Bot commented Aug 27, 2026

Copy link
Copy Markdown
Contributor

Summary

mint broken-links passes but doesn't check heading anchors. A deep anchor scan found 21 broken fragment links across 15 pages (verified against Mintlify's actual slug generation, including badge suffixes and underscores), plus one malformed code fence.

Changes

  • Underscore slugs: #sql-filter-and-pre-aggregates#sql_filter-and-pre-aggregates in pre-aggregates.mdx (3×), lightdash-config-yml.mdx, pre-aggregates/external.mdx. Mintlify keeps underscores from `sql_filter` in the anchor.
  • Wrong anchor: pre-aggregates/monitoring.mdx linked #sql-compatibility (never existed) → #sql_filter-and-pre-aggregates.
  • Badge headings include badge text in the anchor:
    • #post-calculation-metrics#post-calculation-metrics-experimental (metrics.mdx 2×, dimensions.mdx)
    • #sum_distinct#sum_distinct-beta, #average_distinct#average_distinct-beta (metrics.mdx 4×)
    • #initialize-instance#initialize-instance-enterprise (environment-variables.mdx 2×, service-accounts.mdx)
  • Nonexistent headings:
    • metrics.mdx: 8× #using-custom-SQL-in-aggregate-metrics#custom-sql-in-aggregate-metrics (actual heading is "Custom SQL in aggregate metrics")
    • tables.mdx: #sql-filter#sql-filter-row-level-security
    • sql-runner.mdx: #building-charts-in-the-sql-runner#saved-charts-in-the-sql-runner
    • recipes.mdx: dropped dead #personal-access-tokens fragment (page has no such heading)
    • create-custom-fields.mdx: #dbt-write-back#write-back-dimensions-from-custom-dimensions
    • rename-models-and-fields.mdx: #chart-version-history#charts
    • service-accounts.mdx: dead /integrations/dbt/projects#1-automatically%3A-.../workflow/set-up-ci-cd#deploy-changes-to-lightdash
    • joins.mdx: removed link to nonexistent #chained-join-example (the example follows immediately in the same section)
  • Missing anchor target: added <a id="adding-lightdashs-static-ip-addresses-to-your-allow-list" /> in connect-project.mdx. The static IP content lives in an Accordion, which generates no anchor, and 4 links (3 in-page, 1 from connect-through-ssh-tunnel.mdx) pointed at it.
  • Malformed code fence: workflow/cli/reference.mdx was missing a closing ``` in the lightdash slug-update examples, swallowing prose into the code block.

mint validate and mint broken-links both pass.

@mintlify

mintlify Bot commented Aug 27, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
lightdash 🟢 Ready View Preview Aug 27, 2026, 1:18 PM

@github-actions

Copy link
Copy Markdown
Contributor

Documentation validation

✅ All blocking checks passed.

Component system

0 finding(s) across the corpus.

Findings on lines this pull request touched are annotated inline in Files changed.

Download the structured JSON artifact.

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.

0 participants