Azure-devops-docs: argument names and parameter names agreement

[HughDevlin]

The names of the input arguments in the YAML snippet do not match the argument names in the argument column in the Argument section.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: 622daa35-c6a1-dac3-17ee-3f9308fc60cd
• Version Independent ID: 2c28a59b-8ef5-d7ab-46a6-58748ec552f5
• Content: Azure File Copy task - Azure Pipelines
• Content Source: docs/pipelines/tasks/deploy/azure-file-copy.md
• Product: devops
• Technology: devops-cicd
• GitHub Login: @RoopeshNair
• Microsoft Alias: ronai

[RoopeshNair]

Argument column is not meant to be YAML input names. You can use the task assistant to get the YAML snippet.

[HughDevlin]

The actual parameter names do not match the doc, and this is something we should all just get used to? Really?

[HughDevlin]

please re-open and address

[HughDevlin]

The task assistant offers help with exactly FOUR (4) parameters. This task has many more than four (4) parameters. This closure is unacceptable.

[ninallam]

@HughDevlin Once you select the destination type (Blob/VM) in the task assistant, the additional fields that are applicable to that destination type appear.

Azure Blob

Azure VMs

[HughDevlin]

is it Microsoft's position, that since the arguments to this task (all pipeline tasks?) are documented elsewhere (in the task assistant), that Microsoft's documentation on the web (this page) need not be maintained?

[stewartadam]

It's silly to expect everyone to have to use the task assistant just to put together the task... The documentation here demonstrates the task's yaml configuration and so should document the yaml configuration syntax.

Why have this page showing the config options if they're left undocumented?

For help with the task assistant, the built-in "(i)" buttons pop-out with relevant help text. This page shouldn't need to document the use of the assistant.

[ninallam]

We are working on getting all the task docs updated to have the yaml arguments as well. Thanks for your feedback.