Skip to content

docs: mark formula table calcs GA and document missing date functions#573

Merged
joaoviana merged 4 commits intomainfrom
docs/formula-ga-and-warehouses
Apr 29, 2026
Merged

docs: mark formula table calcs GA and document missing date functions#573
joaoviana merged 4 commits intomainfrom
docs/formula-ga-and-warehouses

Conversation

@joaoviana
Copy link
Copy Markdown
Contributor

Summary

The Formula input mode for table calculations is now GA on every warehouse Lightdash supports. This PR aligns the docs with the shipped state.

  • Drops the Beta badges from guides/formula-table-calculations.mdx (sidebar title, intro Info banner, FAQ "beta is strictly additive" line, related-link to feature-maturity-levels) and from guides/table-calculations.mdx.
  • Refreshes the supported-warehouses section — Athena and Trino were marked "🚧 Not yet" but are wired up in packages/formula/src/codegen/dialects.ts (TRINO_CONFIG is shared by both). Replaces the table with a single-line statement that all supported warehouses work.
  • Documents the date functions that are in FUNCTION_DEFINITIONS (packages/formula/src/functions.ts) but were missing from the docs: LAST_DAY, DATE_TRUNC, DATE_ADD, DATE_SUB, DATE_DIFF, including the accepted unit literals.
  • Drops the "What happens if my warehouse isn't supported yet?" FAQ — there is no such warehouse anymore.

Test plan

  • Mintlify preview renders both pages without broken links
  • Date function table displays cleanly on mobile widths
  • No remaining "Beta" mentions in formula table calc context

🤖 Generated with Claude Code

The Formula input mode shipped to GA on every warehouse Lightdash
supports (Athena, BigQuery, ClickHouse, Databricks, DuckDB, PostgreSQL,
Redshift, Snowflake, Trino). Drop the Beta badges and the
unsupported-warehouse callouts, and document the date helpers
(LAST_DAY, DATE_TRUNC, DATE_ADD, DATE_SUB, DATE_DIFF) that were
already in the formula package but missing from the function reference.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@mintlify
Copy link
Copy Markdown
Contributor

mintlify Bot commented Apr 28, 2026

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

Project Status Preview Updated (UTC)
lightdash 🟢 Ready View Preview Apr 28, 2026, 11:09 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 28, 2026

🤖 Documentation Bot

All checks passed! No issues found.

Replaces six stale single-mode jpgs with light/dark PNG pairs captured
against the current UI. Notable UI changes since the old shots:
- Add table calculation modal puts Format inline below the SQL editor
  rather than behind a separate tab.
- Column-header dropdown labels are "Edit calculation" / "Remove" (not
  the gear icon described in the old copy).
- Quick calculation menu now sits under "Add quick calculation" inside
  the metric column dropdown.

Adjusts the surrounding copy to match the current modal structure and
column-dropdown wording. The "table calculation execution and
limitations" filter-example screenshot is unchanged and will be
refreshed in a follow-up — that one needs a multi-TC + filter setup
that's not worth bundling into this PR.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 28, 2026

🤖 Documentation Bot

All checks passed! No issues found.

The old shot still showed the "Formula Beta" tab badge and the older
modal layout. The new modal: "Create Table Calculation" title, Formula
input mode by default with "Use SQL instead" link (no Beta), inline
Format options below the formula box, and a sample formula composed
from field chips.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 28, 2026

🤖 Documentation Bot

All checks passed! No issues found.

…arehouses

# Conflicts:
#	guides/formula-table-calculations.mdx
#	guides/table-calculations.mdx
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 29, 2026

🤖 Documentation Bot

All checks passed! No issues found.

@joaoviana joaoviana merged commit 096b8f5 into main Apr 29, 2026
5 checks passed
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