Example using a {% do return(...) %} statement in a Jinja macro

[dbeatty10]

Preview

What are you changing in this pull request and why?

There's a subtle difference between these two:

• {{ return([1,2,3]) }} (an expression that outputs a string)
• {% do return([1,2,3]) %} (a statement that does not output a string)

This PR adds an example of using the do tag along with the return function.

More detail

The "do" extension (AKA expression-statements) adds a simple do tag to the template engine that works like a variable expression but ignores the return value.

Put another way, there is a difference between expressions and statements in Jinja:

• Expressions {{ ... }}: Expressions are used when you want to output a string. You can use expressions to reference variables and call macros.
• Statements {% ... %}: Statements don't output a string. They are used for control flow, for example, to set up for loops and if statements, to set or modify variables, or to define macros.

Checklist

• Review the Content style guide so my content adheres to these guidelines.
• I've verified that the code example works

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
docs-getdbt-com	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Apr 10, 2024 6:22am

[mirnawong1]

hey @dbeatty10 , looks awesome and made some suggested changes. would love your input!

[dbeatty10]

Thanks for your suggestions @mirnawong1 -- I committed them, and they really improved it overall.

Ready for another review.