Skip to content

feat: add UDTF documentation and reorganize Geneva docs#187

Merged
jmhsieh merged 4 commits intomainfrom
jon/udtfs
Mar 13, 2026
Merged

feat: add UDTF documentation and reorganize Geneva docs#187
jmhsieh merged 4 commits intomainfrom
jon/udtfs

Conversation

@jmhsieh
Copy link
Contributor

@jmhsieh jmhsieh commented Mar 13, 2026

Summary

  • Add two new doc pages for UDTF features introduced in Geneva 0.11.0 (beta):
    • Scalar UDTFs (1:N row expansion) — chunking, splitting, tiling with inherited columns and incremental refresh
    • Batch UDTFs (N:M transformations) — deduplication, clustering, aggregation with partition-parallel execution
  • Add Understanding Transforms overview page comparing UDFs, Scalar UDTFs, and Batch UDTFs with visual table examples
  • Reorganize Geneva docs navigation: Overview → Transforms → Built-in Transforms → Running Jobs → Deployment
  • Polish page titles, descriptions, and cross-references

Test plan

  • Verify all new pages render correctly on Mintlify preview
  • Check nav structure matches expected grouping
  • Verify all internal cross-references resolve (no 404s)
  • Confirm escaped curly braces render properly in markdown tables

🤖 Generated with Claude Code

jmhsieh and others added 4 commits March 12, 2026 20:30
Add two new doc pages for the UDTF features introduced in Geneva 0.11.0:
- Scalar UDTFs (1:N row expansion) for chunking, splitting, tiling
- Batch UDTFs (N:M transformations) for deduplication, clustering, aggregation

Also updates the UDF index page with a UDFs vs UDTFs overview section
and adds both pages to the docs.json navigation.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Add geneva/overview/udfs-and-udtfs.mdx with table-based illustrations
  of 1:1, 1:N, and N:M transformations
- Move comparison table out of scalar-udtfs into the overview page
- Remove UDFs vs UDTFs blurb from UDF index (now in overview)
- Use @udtf instead of @geneva.udtf throughout
- Update scalar UDTF inherited columns example to exclude duration
- Reorder sections: choosing the right type and at-a-glance first

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Reorganize nav: Overview, Transforms, Built-in Providers, Running Jobs,
  Deployment (eliminate Operations group)
- Move Materialized Views to Running Jobs, UDFs and UDTFs to Transforms intro
- Rename "UDFs and UDTFs" → "Understanding Transforms"
- Rename "Working with UDFs" → "UDFs" with spelled-out titles
- Add intro paragraph and description to UDF page
- Rename "Converting functions into UDFs" → "Defining a UDF"
- Use @udtf instead of @geneva.udtf throughout

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Move Understanding Transforms to udfs/index.mdx (group landing page)
- Move UDF reference to udfs/udfs.mdx
- Rename Built-in Providers → Built-in Transforms in nav
- Update all cross-references for new paths
- Clean up trailing whitespace in udfs, blobs

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@@ -1,284 +1,97 @@
---
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The old content of this file moved to udfs.mdx. This now provides an overview and decision workflow for the three types of udfs/udtfs.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good!

Copy link
Contributor

@prrao87 prrao87 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Rendering on staging looks good to me, great flow overall!

@jmhsieh jmhsieh merged commit 8610967 into main Mar 13, 2026
2 checks passed
@jmhsieh jmhsieh deleted the jon/udtfs branch March 13, 2026 19:53
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.

2 participants