no response format for cli calls anywhere in the docs

[Morriz]

How are we supposed to find out the response format of cli call? Trial and error? Please generate docs from code.

---

Document Details

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

• ID: c12e07f8-d82f-a9ac-895a-b6d980c8c4c2
• Version Independent ID: 43924bb5-20bd-6a0e-9cdc-90b1db46e599
• Content: az network public-ip
• Content Source: latest/docs-ref-autogen/network/public-ip.yml
• Service: virtual-network
• GitHub Login: @rloutlaw
• Microsoft Alias: routlaw

[yungezz]

cc @yonzhan since this is network command

[msyyc]

@Morriz Could you describe your question with more details?

[Morriz]

Sure. The docs nicely describe input format, but no output format. This is usually found in reference documentation, but I have a hard time finding such machine generated api docs here.

[yonzhan]

@Morriz Could you please share the doc link you mentioned?

[Morriz]

I am talking about all your az cli documentation. All input parameters are always nicely given, and some examples. None give response formats, even though your docs mention to be "Azure CLI / Reference".

Sample links:

• https://docs.microsoft.com/en-us/cli/azure/aks?view=azure-cli-latest#az_aks_create
• https://docs.microsoft.com/en-us/cli/azure/keyvault?view=azure-cli-latest#az_keyvault_create

Nowhere do you provide response formats. Why?