[Core] Jinja context variables versus dbt Jinja functions

[dbeatty10]

Link to the page(s) on docs.getdbt.com requiring updates

This page is a mix of documentation for functions and variables:
https://docs.getdbt.com/reference/dbt-jinja-functions

But the page title only mentions "dbt Jinja functions" and does not include "Jinja context variables".

Also, the base URL includes /dbt-jinja-functions/ which feels odd for a page like the schemas context variable (which is not a function):
https://docs.getdbt.com/reference/dbt-jinja-functions/schemas

Tell us more about this update

See above.

Reviewers/Stakeholders/SMEs

😎

Related GitHub issues

Here's two other docs issues that are tangentially related:

• [Core] The schemas context variable has its own page but database_schemas does not #5117
• [Core] The schemas context variable has its own page but invocation_args_dict does not #5118

Additional information

No response

[nataliefiann]

Hiya @dbeatty10

Happy Tuesday, I hope you're well.

Can you kindly let me know what you'd like updating please?

Kind Regards
Natalie

[dbeatty10]

The big idea is delineating the Jinja functions from the Jinja context variables. Right now, the context variables are all just lumped in with the functions (but they aren't functions!).

We've got a couple main options:

1. Leave them all together, but update the page title and URL to include both "functions" and "variables"
2. Create a new page and move the context variables to that page

If we choose option 1, the most simple approach would to be rename the title of the page from "dbt Jinja functions" to "dbt Jinja functions and context variables".