az vm create: --ssh-key-value docs quite confusing

[ahmetb]

az vm create says:

    --ssh-key-value               : SSH public key or public key file path.

OK I think an argument should either accept a file OR a file contents. Not both. It's unintuitive and opens a clear path to bugs and more discoverability issues. Many CLIs have solved this problem by doing things like

• If the input string starts with @, then it's a path
• If the input string is -, read from STDIN
• ...

Please make this either --ssh-key [path] or --ssh-key-value [value].

[mayurid]

Johan Stenberg (ex-msft) (@johanste) : Looks like something that we can adjust based on your PR #738

[mayurid]

Johan Stenberg (ex-msft) (@johanste) : Confirm and close?

[johanste]

ahmetalpbalkan (old account) (@ahmetalpbalkan)'s concern is still valid in some cases - have to check if that is true here. The potential issue is that when given an explicit path, there may be processing done on the input. If so, there is a difference between using the @ notation and just specifying a path to the file....

[yugangw-msft]

This is not compute specific issue.