dbt-labs / docs.getdbt.com

The code behind docs.getdbt.com
https://docs.getdbt.com/
Apache License 2.0
128 stars 960 forks source link

Clarify deferral content #4408

Open mirnawong1 opened 1 year ago

mirnawong1 commented 1 year ago

Contributions

Link to the page on docs.getdbt.com requiring updates

I think the overall message is that our ability to run models based on new data in sources is really powerful but without the video Sung created, they wouldn't have known it existed because it's difficult to piece all of the parts together like the method and the defer capabilities. <--This is what I walked them through about 2 months ago. Once we pieced it all together and got it working, we removed the ability for them to reference a specific job which caused more confusion. They have everything up and running and now pointing to an environment so all is good for now but I figured it was worth sharing the feedback because I think this is something potentially worth of it's own call out in our docs similar to setting up a CI job. Something like "Build models based on source Freshness" and it essentially just documents what Sung's process

Screenshot 2023-11-09 at 7 48 19 AM

What part(s) of the page would you like to see updated?

mirnawong1 commented 2 months ago

Ly and Leona will review data on defer for additional context on issue prioritization

nataliefiann commented 2 weeks ago

Notes for self

  1. Don't use vid in Slack
  2. From Slack "how source freshness works" (https://docs.getdbt.com/docs/deploy/source-freshness)