Skip to content

docs: give macros an overview of SQL and Python macros, and a Python macros page - #1235

Merged
kvlonge merged 1 commit into
mainfrom
docs/macros-overview
Oct 23, 2026
Merged

kvlonge merged 1 commit into
mainfrom
docs/macros-overview

Conversation

@kvlonge

@kvlonge kvlonge commented Oct 23, 2026

Copy link
Copy Markdown
Contributor

Why

The Macros section opened on a page titled "Writing Macros" that described only Python macros, with SQL macros as an aside, even though SQL macros are the simpler default.

Changes

  • concepts/macros is now an overview: the two kinds side by side, where they live, how calls name their kind, using them together, where macros work, test-only placement, and choosing between a SQL macro, Python macro, SQL function or audit.
  • New concepts/macros/python-macros page with the Python macro content.
  • SQL macros page links to the overview for choosing; the composition page is titled as Python-specific.
  • Sidebar order: overview, SQL macros, Python macros, Python composition and context.
  • Links into moved sections updated; docs skill regenerated.

Verification

  • Website build passes; every link and anchor to the macro pages resolves.

@kvlonge
kvlonge enabled auto-merge (squash) October 23, 2026 09:29
@kvlonge
kvlonge merged commit 2838635 into main Oct 23, 2026
22 checks passed
@kvlonge
kvlonge deleted the docs/macros-overview branch October 23, 2026 09:29
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