how to: "update your pipeline by editing DVC-files"

[efiop]

See iterative/dvc#1800 (comment) .

Might be worth publishing under "Best Practices" #72 .

[dnabanita7]

Can I take this up? I will first summarize it then write markdown for it.

[shcheklein]

@naba7 sounds good. But it should be part of the User Guide section - "Updating DVC-files" - or something like this.

[dnabanita7]

@shcheklein

How to update your pipeline by editing dvc files

1)using dvc move to edit file paths of outputs or dependencies.
2)editting by hand the outputs paths
3)dvc run to make edits in the dependency files

If your source file is a data file, then use dvc move:
dvc move
dvc move is used if a file or a directory has been added to DVC with dvc
add. the source file or directory is moved to its destination path, renamed
and corresponding DVC-file is updated.

If your source file isn't data file then use dvc run. If you use dvc add then git mv command
then your path isn't updated. So, using git mv is not an option.

dvc run is used to create a dvc pipeline. It can be shown in a connected graph.
While running dvc run and executing commands with [-f,-o,-O,-m,-M] you can edit your files
and directories by hand. dvc run connects each individual staged commands to a graph.

is this okay? or any edits

[jorgeorpinel]

Closing in favor of #72