-
Notifications
You must be signed in to change notification settings - Fork 1.3k
plots: point template help info to manual #3830
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
Conversation
dvc/command/plots.py
Outdated
This comment was marked as outdated.
This comment was marked as outdated.
Sorry, something went wrong.
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.
I found this https://github.com/vega/schema are templates basically this? Vega schema files. If so, I suggest
| "Vega specification file to inject with the data. " | |
| "Vega JSON schema file to inject with the data. " |
and will update the docs to link to this repo for reference.
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.
Hmm actually template is an Vega JSON schema with DVC placeholders (anchors) that will be filled with proper values after using dvc plots. Also, template does not have to be JSON at all,
that is bad on my side. If user wants it can be HTML as well, the only thing that makes it template is existence of DVC_METRIC_DATA anchor inside.
Also this might change depending on discussion under #3818
So I think that as of now, the best description would be to leave it as is (File to be injected with data. See {link}
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.
OK np let's just come up with a general description here and we'll have to revisit the docs to explain this a little better. The anchors are listed but it's not clear that templates are a combo of Vega schema and DVC anchors + possibly HTML. TBH I still don't totally get it haha. But how about
| "Vega specification file to inject with the data. " | |
| "Special JSON or HTML schema to inject with the data. " |
?
Also this might change depending on discussion under #3818
No worries. We can revisit this and docs if/when that happens.
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.
p.s. added checkbox to improve plot template desc. to #1175.
jorgeorpinel
left a comment
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.
Forgot a little detail but yes, looks good. Thanks!
Co-authored-by: Jorge Orpinel <jorgeorpinel@users.noreply.github.com>
β I have followed the Contributing to DVC checklist.
π If this PR requires documentation updates, I have created a separate PR (or issue, at least) in dvc.org and linked it here. If the CLI API is changed, I have updated tab completion scripts.
β I will check DeepSource, CodeClimate, and other sanity checks below. (We consider them recommendatory and don't expect everything to be addressed. Please fix things that actually improve code or fix bugs.)
Thank you for the contribution - we'll try to review it as soon as possible. π
Fixes #3755