Customer feedback | az pipelines create | create cli notes for "Azure Repo" does not work

[dbradish-microsoft]

Describe the bug

This GitHub issue is being moved from azure-docs-cli 4481 as the feedback is on autogenerated reference content controlled by source code.

Suggestion to engineering: Use the long-summary property to provide more information on "parameter pairs" or "this parameter is required when ...", and parameter value formatting.

---

Type of issue
Code doesn't work

Feedback
all comments are for documentation on https://learn.microsoft.com/en-us/cli/azure/pipelines , in specific notes related to "az pipelines create" for "Azure Repo" did not work for me.

there are more "required" parameters than just --name, I suppose organization & project are mandatory. i was asked to explicitly specify by the azcli
"--detect true" did not work for me.
my command "az pipelines create --name 'pipeline_via_azcli' --description 'az pipeline via cli' --repository myrepo --branch main --repository-type tfsgit --organization https://dev.azure.com/myorg --project myproject --skip-first-run true" errors with "The controller for path '/terraform/_apis/pipelines/Templates/recommendedtemplates' was not found or does not implement IController. Operation returned a 404 status code." Note: my other repos in the same project have main branch so using that instead of master as per documentation
above command did not work when the repo was empty nor with files in the repo (README.md & azure-pipelines.yml)
"--skip-first-run true" made no difference. probably because pipeline is not created

Page URL
https://learn.microsoft.com/en-us/cli/azure/pipelines?view=azure-cli-latest#az-pipelines-create

Content source URL
https://github.com/MicrosoftDocs/azure-docs-cli/blob/main/latest/docs-ref-autogen/pipelines.yml

---

Related command

az pipelines create

Errors

Please see description for customer error information.

Issue script & Debug output

n/a

Expected behavior

n/a

Environment Summary

n/a

Additional context

n/a

[yonzhan]

Thank you for opening this issue, we will look into it.

[microsoft-github-policy-service]

Thanks for the feedback! We are routing this to the appropriate team for follow-up. cc @v-anvashist, @V-hmusukula.

[srijayam]

attaching debug log debug_log.txt