You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
One thing I think we should not do as Git is to have inconsistent options (and API parameters) (e.g. git branch -D vs. git remote remove). Better consistency in command/subcommand usage decrease the learning curve and makes for an enjoyable CLI (heroku is a good example).
Here's the ones I've found after briefly checking all refs:
--show-json vs --show-hash/--show-url (different meaning of "show")
--show-json vs --ascii
Order of standard -hqv options in help output. Usually they're shown first as [-h] [-q | -v] but not always, for example remote ... [-h] [--global] [--system] [--local] [-q | -v]
config name [value] vs dvc remote modify name option [value]
maybe remove -p (purge) vs repro -p (pipeline)
This may seem like a polishing thing but I think it's actually best to address sooner than later, before too many users learn the existing options which makes it harder to change them. In any case, renamed options should be left hidden for some time, for legacy/scripting support.
One thing I think we should not do as Git is to have inconsistent options (and API parameters) (e.g.
git branch -D
vs.git remote remove
). Better consistency in command/subcommand usage decrease the learning curve and makes for an enjoyable CLI (heroku
is a good example).Here's the ones I've found after briefly checking all refs:
add/run/import -f
(DVC-file name)checkout/init/etc -f
(force)get-url/import-url [out]
vs.get/import --out
vsmove dst
gc --projects REPOS
– is it project or repo?add targets
,metric diffs --targets
vs.metrics ... path
(orpath
API param)UPDATE: and now
list url target
? See addressdvc list
review from Jorge #3381 (comment)--show-json
vs--show-hash/--show-url
(different meaning of "show")--show-json
vs--ascii
[-h] [-q | -v]
but not always, for exampleremote ... [-h] [--global] [--system] [--local] [-q | -v]
config name [value]
vsdvc remote modify name option [value]
remove -p
(purge) vsrepro -p
(pipeline)This may seem like a polishing thing but I think it's actually best to address sooner than later, before too many users learn the existing options which makes it harder to change them. In any case, renamed options should be left hidden for some time, for legacy/scripting support.
Other misc. comments:
repro --pull
is specific to the run-cache.Should it be
--pull-run-cache
? See ref: exp-related updates in other to cmds, etc. dvc.org#2242 (review) (also rel Make thatdvc repro --pull
pulls all missing files. #4742)The text was updated successfully, but these errors were encountered: