Open dbradish-microsoft opened 1 month ago
Thank you for opening this issue, we will look into it.
Here are some similar issues that might help you. Please check if they can solve your problem.
Thanks for the feedback! We are routing this to the appropriate team for follow-up. cc @zhangyd2015, @Frey-Wang, @Jingshu923.
Thanks for the feedback! We are routing this to the appropriate team for follow-up. cc @kamperiadis, @khkh-ms, @shreyabatra4.
Thanks for the feedback! We are routing this to the appropriate team for follow-up. cc @SameergMS, @yairgil.
Thanks for the feedback! We are routing this to the appropriate team for follow-up. cc @AzureAppServiceCLI, @antcp.
Summary: We have a recurring theme in our customer verbatims that optional parameters are required. See example verbatims in the the table below. There is some information given in error handling, but we need better clarity in our autogenerated content.
The misunderstanding might be coming from the following:
required
andoptional
.optional
heading.Suggestion: We either need a third parameter category of
conditional
or similar, and/or we need our engineering teams to take advantage of thelong-summary
property and provide this useful information.Customer suggestion azDO link: https://ceapex.visualstudio.com/Engineering/_workitems/edit/987623 (Permission is required to access.)
Example customer verbatims:
Disclaimer: This suggestion assumes there is no customer error in this feedback, just a misunderstanding of when an optional parameter is required.