Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve Jinja resources #358

Open
5 tasks
tamsinforbes opened this issue Jul 19, 2023 · 0 comments
Open
5 tasks

Improve Jinja resources #358

tamsinforbes opened this issue Jul 19, 2023 · 0 comments
Labels
Data Platform Core Infrastructure This issue is owned by Data Platform Core Infrastructure

Comments

@tamsinforbes
Copy link
Contributor

This could be split into general Jinja guidance in it's own page on AP User Guidance and guidance specific to create-a-derived-table in its pages with internal links to former.

As an analyst and engineer I need specific examples of what other people have done regarding Jinja resources and writing macros; manuals, example code, tutorials, run logs to look at the compiled Jinja code translated into SQL/Data Definition Language or Data manipulation language so I can check it wrote the SQL code to be run and is what I expected it to do, and examples of how to name macros, where to save them and how to invoke them, pass variables etc.

As User Guidance is public facing perhaps don't want to mention specific names of databases/tables

Should include

  • links to Jinja docs
  • example code, how to pass variables, other common requirements
  • (check the "single use" variable issue 445)
    Specific to create-a-derived-table
  • how to find the run logs to see compiled Jinja code
  • best practise for naming macros, where to save them, how to invoke them, pass variables
@tamsinforbes tamsinforbes added the Data Platform Core Infrastructure This issue is owned by Data Platform Core Infrastructure label Jul 19, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Data Platform Core Infrastructure This issue is owned by Data Platform Core Infrastructure
Projects
None yet
Development

No branches or pull requests

1 participant