search

Azure / azure-cli-extensions

Public Repository for Extensions of Azure CLI.
https://docs.microsoft.com/en-us/cli/azure
MIT License
383 stars 1.24k forks source link

az functionapp app up | In in-line help, provide list of azCLI reference commands being executed #8088

Open dbradish-microsoft opened 8 months ago

dbradish-microsoft commented 8 months ago

Describe the bug

Customers are asking what Azure CLI reference commands are being executed by our az ... up commands. Doc writers are also requesting this information when they must replicate Azure CLI docs with Azure PowerShell commands. Although the reference list might change based on the parameters being passed, we need clarity in our in-line help and resulting autogenerated reference content.

Reference command link: https://learn.microsoft.com/en-us/cli/azure/functionapp/app?view=azure-cli-latest#az-functionapp-app-up

Current description: Deploy to Azure Functions via GitHub actions.

REQUEST: Please modify this description to list each Azure CLI reference command that "up" can/is executing.

Possible impacted source code file (where this description is found): https://github.com/azure/deploy-to-azure-cli-extension/blob/master/deploy-to-azure/azext_deploy_to_azure/dev/functionapp/help.py

Related command

az functionapp app up

Errors

n/a

Issue script & Debug output

n/a

Expected behavior

n/a

Environment Summary

Azure CLI 2.58.0

Additional context

No response

azure-client-tools-bot-prd[bot] commented 8 months ago
Hi @dbradish-microsoft Find similar issue https://github.com/Azure/azure-cli-extensions/issues/8060.
Issue title az aks app up Provide list of azCLI reference commands being executed in in-line help
Create time 2024-03-14
Comment number 0

Please confirm if this resolves your issue.

yonzhan commented 8 months ago

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

microsoft-github-policy-service[bot] commented 8 months ago

Thanks for the feedback! We are routing this to the appropriate team for follow-up. cc @AnatoliB, @Francisco-Gamino, @shreyabatra4.

dbradish-microsoft commented 4 months ago

@AnatoliB, @Francisco-Gamino, @shreyabatra4:

Can we resolve this issue by putting a sentence in the short or long summary that states something like "Run this command with the --debug parameter to see the API calls and parameters values being used."?

This avoids a lengthy long-summary property, but tells the customer how to find the answer for themselves.