Skip to content

docs: add inline givens and in $array to givens experiment page#313

Merged
mtoy-googly-moogly merged 1 commit into
mainfrom
docs/givens-inline-and-array-in
May 13, 2026
Merged

docs: add inline givens and in $array to givens experiment page#313
mtoy-googly-moogly merged 1 commit into
mainfrom
docs/givens-inline-and-array-in

Conversation

@mtoy-googly-moogly
Copy link
Copy Markdown
Contributor

@mtoy-googly-moogly mtoy-googly-moogly commented May 13, 2026

Summary

  • Adds an Array givens and in section covering expr in $arrayGiven (and not in), including the type-match rule and empty/null-array behavior.
  • Adds an Inline givens section covering the inline modifier — eager-evaluated at bind time, used for the row-level access control capability-gate pattern — with allowed operator/leaf surface and a small "when to reach for inline" decision table.
  • Notes in the Introspection section that inline givens are excluded from Model.givens / PreparedQuery.givens (computed, not supplied).

Both extensions are integrated as native features of the givens experiment, not as add-on patterns. The doc still lives at src/documentation/experiments/givens.malloynb.

Test plan

  • Build the docs site locally and verify the new sections render cleanly and anchor links resolve (#array-givens-and-in, #inline-givens).
  • Spot-check the inline Malloy example renders as code, not as an executable Malloy cell.

🤖 Generated with Claude Code

Covers the two extensions landing alongside the givens MVP: array-typed
givens used with `expr in $arrayGiven`, and the `inline` modifier that
eager-evaluates a given's default at bind time (the RLAC capability-gate
pattern). Introspection section notes inline givens are excluded from
the public surfacing APIs.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@mtoy-googly-moogly mtoy-googly-moogly force-pushed the docs/givens-inline-and-array-in branch from e2bb907 to d582660 Compare May 13, 2026 04:27
@mtoy-googly-moogly mtoy-googly-moogly merged commit be353b8 into main May 13, 2026
5 checks passed
@mtoy-googly-moogly mtoy-googly-moogly deleted the docs/givens-inline-and-array-in branch May 13, 2026 04:28
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