`bicep build-params` only builds parameter file with `--outfile`, but template file too with `--stdout`

[o-l-a-v]

Bicep version

0.27.1 (4b41cb6)

Describe the bug

bicep build-params with a bicepparam file as input behaves differently depending on what output you specify, --stdout vs. --outdir.

• --stdout returns a full template with the .bicep file the .bicepparam points to.
• --outdir only creates a parameters.json file.

I can't find info saying this difference is intended:

• az build: https://learn.microsoft.com/en-us/cli/azure/bicep?view=azure-cli-latest#az-bicep-build
• az build-params: https://learn.microsoft.com/en-us/cli/azure/bicep?view=azure-cli-latest#az-bicep-build-params

To Reproduce

Bicep v0.27.1 (4b41cb6), a params.bicepparam poiting to a main.bicep. Watch difference of output when:

az bicep build-params --file ".\params.bicepparam" --stdout
# or
bicep build-params ".\params.bicepparam" --stdout

# VS

az bicep build-params --file ".\params.bicepparam" --outdir ".\"
# or
bicep build-params ".\params.bicepparam" --outdir ".\"

Additional context
Add any other context about the problem here.

[polatengin]

I have created a PR on the Azure/azure-cli repo #32989 with a documentation update.

After it's reviewed/merged, the Microsoft Learn portal will be updated and it'll resolve the confusion 👍