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

dvc.yaml: encourage manual writing/editing stages (and pipelines) #2578

Closed
2 tasks
jorgeorpinel opened this issue Jun 22, 2021 · 2 comments
Closed
2 tasks
Labels
A: docs Area: user documentation (gatsby-theme-iterative) duplicate This issue or pull request already exists. type: discussion Requires active participation to reach a conclusion.

Comments

@jorgeorpinel
Copy link
Contributor

jorgeorpinel commented Jun 22, 2021

The intention since DVC 2.0 is to do so (per iterative/dvc#5180 (comment)).

  • State this clearly in the docs, and the why (advanced dvc.yaml features?)
    Try to use a descriptive rather than prescriptive explanation...

stage add is still clearly useful, perhaps even preferred for certain cases:

  • Simple stages or beginner users e.g. dvc stage add -n test echo test

  • Programmatic stage generation, esp. to "bootstrap" a pipeline structure (to manage manually later)

  • How should this be reflected in docs?

@jorgeorpinel jorgeorpinel added type: discussion Requires active participation to reach a conclusion. A: docs Area: user documentation (gatsby-theme-iterative) labels Jun 22, 2021
@jorgeorpinel
Copy link
Contributor Author

jorgeorpinel commented Jun 22, 2021

May be good as a best practice too (#72). In fact it was already mentioned there...

@skshetry skshetry mentioned this issue Sep 23, 2021
7 tasks
@jorgeorpinel jorgeorpinel changed the title dvc.yaml: encourage users to write/edit stages and pipelines manually dvc.yaml: encourage manual writing/editing stages (and pipelines) Jan 28, 2022
@jorgeorpinel
Copy link
Contributor Author

jorgeorpinel commented Jan 28, 2022

How should this be reflected in docs?

I guess this is basically a dupe of #2076!

@jorgeorpinel jorgeorpinel added the duplicate This issue or pull request already exists. label Jan 28, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
A: docs Area: user documentation (gatsby-theme-iterative) duplicate This issue or pull request already exists. type: discussion Requires active participation to reach a conclusion.
Projects
None yet
Development

No branches or pull requests

1 participant