docs: add Formula table calculations (Beta) guide#558

Merged

joaoviana merged 6 commits intomainfrom

docs/formula-table-calculations-beta

Apr 22, 2026

Contributor

joaoviana commented Apr 21, 2026

Summary

Announces the Beta launch of formula-based table calculations — a Google Sheets-style alternative to writing raw SQL for table calculations — and documents the supported warehouses, syntax, function catalog, examples, and FAQs.

What's in this PR

New guide — `guides/formula-table-calculations.mdx`: beta callout, why formulas, supported warehouse matrix (BigQuery, ClickHouse, Databricks, DuckDB, PostgreSQL, Redshift, Snowflake — Athena & Trino coming later), function reference grouped by category (math / logical / string / date / aggregation / window / null), worked examples, and an AccordionGroup FAQ.
Overview page update — `guides/table-calculations.mdx`: adds a beta `` callout and a short "two ways to build table calculations" intro linking to the new guide.
Navigation — `docs.json` adds the new guide under the Analyst guides group alongside the existing table-calculations entry.

Paired with

Product PR: lightdash/lightdash#22147 — drops the feature flag and enables formulas by default on supported warehouses.

Test plan

Preview the new guide in the Mintlify preview — formatting, tables, AccordionGroup
Verify the new entry appears in the sidebar at the expected position
Confirm links (maturity levels, related pages) resolve
Proof-read the FAQ and examples


          docs: add Formula table calculations (Beta) guide

1fd411f

Announces the beta launch of formula-based table calculations and
documents the supported warehouses, formula syntax, function catalog,
worked examples, and FAQs. Updates the table-calculations overview
with a beta callout pointing at the new guide. Wires the new page
into docs.json navigation.

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

Contributor

github-actions Bot commented Apr 21, 2026 •

edited

Loading

🤖 Documentation Bot

✅ All checks passed! No issues found.


          docs(formula): add screenshots with light and dark variants

c8a79dd

- "Creating a formula table calculation" — placed under the intro
- "Formula in the results table" — placed under the first-formula
  section

Both rendered with Mintlify's className="block dark:hidden" /
className="hidden dark:block" pattern so the correct variant shows
per theme.

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

Contributor

github-actions Bot commented Apr 21, 2026 •

edited

Loading

🤖 Documentation Bot

✅ All checks passed! No issues found.


          docs(nav): nest table-calc pages under a Table calculations group

f8d3d27

Removes the IA weirdness where "Table calculations" (overview) and
"Formula table calculations" (Beta guide) were peer entries. Now they
live inside a single "Table calculations" group, alongside the existing
"Table calculation functions" and "SQL templates" sub-groups (latter
renamed from "Table calc SQL templates" — cleaner given the parent
group already names the topic).

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

Contributor

github-actions Bot commented Apr 21, 2026 •

edited

Loading

🤖 Documentation Bot

✅ All checks passed! No issues found.

mintlify Bot deployed to staging

April 21, 2026 13:14

View deployment


          docs(nav): shorten table-calc sidebar labels

cf8cee2

The "Table calculations" group had every child repeating "Table
calculations" in its label, which made the sidebar read as a stutter.
Use sidebarTitle frontmatter and inner-group rename to trim labels
while keeping the full page titles (and URLs) intact:

- guides/table-calculations → "Overview"
- guides/formula-table-calculations → "Formula (Beta)"
- Inner group "Table calculation functions" → "Functions"

In-page headings and SEO titles are unchanged; URLs are unchanged.

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

Contributor

github-actions Bot commented Apr 21, 2026 •

edited

Loading

🤖 Documentation Bot

✅ All checks passed! No issues found.


          docs(formula): tighten prose, drop em dashes

bac86cd

Replaces em dashes introduced in the initial draft with periods,
commas, colons, and parentheses as appropriate. The em-dash-heavy
voice felt AI-written; the result reads more naturally.

Also:
- Changes bullet-list separators from "Label — value" to "Label: value".
- Replaces "Google Sheets–style" with "spreadsheet-style" where the
  Google-Sheets comparison was already made elsewhere in the paragraph.
- Applies the same treatment to the two-bullet intro and the Beta
  callout in the table-calculations overview.

Pre-existing em dashes elsewhere in table-calculations.mdx are
intentionally left untouched.

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

Contributor

github-actions Bot commented Apr 21, 2026 •

edited

Loading

🤖 Documentation Bot

✅ All checks passed! No issues found.


          docs(formula): trim the FAQ to three entries

2a430dd

Drops three FAQs that were filler:
- "Does the formula run on my warehouse?" (answer was obvious)
- "Can I mix aggregates and scalar expressions?" (niche; the function
  reference already implies yes)
- "How do I reference a field with unusual characters?" (edge case
  already covered by the "use SQL" escape-hatch in the intro)

Also simplifies the "I found a bug" FAQ to the standard Slack + GitHub
pattern used in contact/contact-info.mdx, rather than a bespoke copy.

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

Contributor

github-actions Bot commented Apr 21, 2026 •

edited

Loading

🤖 Documentation Bot

✅ All checks passed! No issues found.

joaoviana merged commit 3760b96 into main

4 checks passed

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet