dvc.org icon indicating copy to clipboard operation
dvc.org copied to clipboard
verified publisher icon iterative

`plots`: soft-deprecate stage-level plot definitions

Open dberenbaum opened this issue 3 years ago • 2 comments

We can soft-deprecate plots inside stages (see https://github.com/iterative/example-repos-dev/pull/117#issuecomment-1175197428)... references to plots inside stages in the cmd-ref and dvc.yaml description

Originally posted by @dberenbaum in https://github.com/iterative/dvc.org/issues/3691#issuecomment-1182017982

dberenbaum avatar Jul 12 '22 17:07 dberenbaum

p.s. we need to update dvc plots modify (see https://github.com/iterative/dvc/issues/7753) to work with top-level plots before we can deprecate stage-level plots

Originally posted by @dberenbaum in https://github.com/iterative/dvc.org/pull/3691#issuecomment-1183541808

jorgeorpinel avatar Jul 17 '22 19:07 jorgeorpinel

@dberenbaum would this also mean to update https://dvc.org/doc/start/data-management/metrics-parameters-plots and any other docs that currently show stage-level plot definitions? E: I guess so!

jorgeorpinel avatar Jul 19 '22 20:07 jorgeorpinel

As noted by @shcheklein, we may want to wait on this since there's no support for advanced scenarios like foreach in top-level plots.

dberenbaum avatar Nov 18 '22 19:11 dberenbaum

We have done more to emphasize top-level plots and explain the differences between them and stage-level plots. No further action planned for now.

dberenbaum avatar May 03 '23 20:05 dberenbaum