Skip to content

docs(4-data-queries): document transform additive mode and in-place JSON parsing#222

Merged
maximelb merged 1 commit into
masterfrom
docs/template-transforms-additive-mode
May 8, 2026
Merged

docs(4-data-queries): document transform additive mode and in-place JSON parsing#222
maximelb merged 1 commit into
masterfrom
docs/template-transforms-additive-mode

Conversation

@maximelb
Copy link
Copy Markdown
Contributor

@maximelb maximelb commented May 8, 2026

Summary

  • Document that adapter transforms operate in replacement mode by default (no +/- keys = original event is discarded) vs additive mode (any +/- key flips the whole transform to additive, even when mixed with non-prefixed keys).
  • Add a worked example for the common case of an adapter event containing a stringified JSON field, using +event_data: "event_data|@parsejson" to decode in place while preserving the rest of the event.

Test plan

  • Render the docs site locally and verify the new sub-sections appear correctly under "Template Strings and Adapter Transforms" in docs/4-data-queries/template-transforms.md
  • Confirm the internal anchor links (#transforms, #custom-modifiers) resolve

🤖 Generated with Claude Code

…SON parsing

Clarify that adapter transforms run in replacement mode by default and
flip to additive mode when any key is prefixed with + or -. Add a worked
example showing how to decode a stringified JSON field in place using
+field: "field|@ParseJson".

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@maximelb maximelb requested a review from steveatlc May 8, 2026 03:25
@maximelb maximelb added the to-code-review Used to tag PRs that are force-pushed and will need to be reviewed after the fact. label May 8, 2026
@maximelb maximelb marked this pull request as ready for review May 8, 2026 03:26
@maximelb maximelb merged commit ea5943f into master May 8, 2026
2 checks passed
@maximelb maximelb deleted the docs/template-transforms-additive-mode branch May 8, 2026 03:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

to-code-review Used to tag PRs that are force-pushed and will need to be reviewed after the fact.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant