Document short aliases --csv/--json/--md flags

[skshetry]

We replaced --show-csv/--show-json/--show-md with short aliases --csv/--json/--md respectively in treeverse/dvc#6711. Though even if the --show-* are still supported, I am removing those mentions from the docs, as it may confuse users. I did not touch blogs when making the changes.

The change is not released yet, so we may want to wait for merging this.

[daavoo]

@iterative/docs this feels like the kind of change that should be associated with a release number somehow.

I can imagine people trying to run the command from previous versions and failing.

[casperdcl]

I suppose it's fine to leave --show-hash as-is.

Also older versions of DVC will fail with e.g. --json as @daavoo pointed out but I don't think it's a problem:

• would require old version of DVC but reading new version of docs (affects few people)
• it's easy to run --help to find out supported flags

[jorgeorpinel]

this feels like the kind of change that should be associated with a release number somehow

That's up to the core team cc @efiop what's the planned version for this, perhaps a minor release increment?

[jorgeorpinel]

@skshetry could you remind us about this when the feature is released? Thanks

[skshetry]

@jorgeorpinel, ping. 2.8.0 was released yesterday.

[casperdcl]

@jorgeorpinel maybe we could wait a few days before merging? to reduce chance of potential issues from users of old versions reading current docs? #2877 (review)

[daavoo]

@jorgeorpinel maybe we could wait a few days before merging? to reduce chance of potential issues from users of old versions reading current docs? #2877 (review)

Sounds a little like a flaky heuristic 👼

[casperdcl]

we should used anonymised analytics to be more objective :)

[jorgeorpinel]

Looks like a grep replace which is what we needed. Thanks @skshetry !