Differentiate between expressions that print and statements that don't

[dbeatty10]

Preview

What are you changing in this pull request and why?

Instigated by dbt-labs/dbt-core#9113 (comment)

We want to briefly explain the differences between expressions that print out and statements that don't.

At the same time, we don't want to fully replicate all the Jinja documentation.

Here's a quick table to explain the behavioral differences between the types of delimiters ("curlies"):

Name	Delimiter	Executes	Prints
Expression	{{ ... }}	✅	✅
Statement	{% ... %}	✅	❌
Comment	{# ... #}	❌	❌

The Jinja docs for the different types of delimiters has the advantage of being brief, but lacks clarity especially as it relates to whether statements print out or not (they don't). Since the “do” aka expression-statement is an optional extension in Jinja, it isn't documented in list of control structures.

🎩

After

Before

Checklist

• Review the Content style guide so my content adheres to these guidelines.
• I have checked that the preview renders correctly
• I have checked that the new links work correctly

[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	Dec 18, 2023 8:29pm