-
Notifications
You must be signed in to change notification settings - Fork 1.5k
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
Add Automation Page #23659
Add Automation Page #23659
Conversation
✅ Deploy Preview for dagsterapidocs canceled.
|
ff56dec
to
a1e275c
Compare
Deploy preview for dagit-core-storybook ready! ✅ Preview Built with commit ff56dec. |
a1e275c
to
8e9ad76
Compare
Deploy preview for dagster-docs ready! Preview available at https://dagster-docs-ihiqwnbgj-elementl.vercel.app Direct link to changed pages: |
Deploy preview for dagster-docs-next ready! ✅ Preview Built with commit 242a28c. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Overall I think this is good. I'm a little curious what the concept page for automation will look like, given how high-level this is. D'you think it may wind up being duplicative?
By understanding and effectively using these automation methods, you can build more efficient data pipelines that respond to your specific needs and constraints. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
lol ty for removing this
I was worried about that too. I've started writing it now so we'll have something to compare with. I think the Concept/Explanation page will be more in-depth. I saw it described as 'bathtub-reading' which kind of makes sense. It will talk about things like ticks, the dagster-daemon, maybe a little history (e.g. Schedules were created during the Op era which is why they are focused around jobs and ops), some corner cases like daylight savings time, how to think about timezones. My mental model, and I don't know how good it is, is that |
9b762f6
to
242a28c
Compare
This adds a "How to Automate Pipelines" guide. The idea behind this page is that it serves as the entry point for Automation. We explain the three ways to automate, each example offers links to a How-To guide with examples for that concept, and potentially a concept page. Not every idea needs a concept page. For example, Asset Sensors may only need a Guide and Reference API documentation.
I did not include the section on Declarative Automation, but it would also fall here.