azure-cli-extensions icon indicating copy to clipboard operation
azure-cli-extensions copied to clipboard

az redisenterprise | HTML tags are rendering as empty parameter values in reference docs

Open dbradish-microsoft opened this issue 1 year ago • 3 comments

Describe the bug

Problem to solve:

HTML tags in source code are causing build warnings in MicrosoftDocs/azure-docs-cli. More importantly, customer-facing reference docs are not instantiating properly -- parameter values formatted with `<>` are missing. Here's an example: image

Requested solution:

These values should be escaped with a backtick. Here's an example from az webpubsub. image

Related GitHub issues:

This is the same issue as these GitHub issues.

List of HTML tag instances that need update:

File name Build error
latest/docs-ref-autogen/redisenterprise.yml HTML attribute 'uuid' on tag 'sub' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
latest/docs-ref-autogen/redisenterprise.yml HTML tag 'resource' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
latest/docs-ref-autogen/redisenterprise.yml HTML attribute 'uuid' on tag 'sub' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
latest/docs-ref-autogen/redisenterprise.yml HTML tag 'resource' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
latest/docs-ref-autogen/redisenterprise.yml HTML tag 'indexToRemove' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
latest/docs-ref-autogen/redisenterprise.yml HTML tag 'value' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
latest/docs-ref-autogen/redisenterprise/database.yml HTML tag 'indexToRemove' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
latest/docs-ref-autogen/redisenterprise/database.yml HTML tag 'value' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.

Related command

az redisenterprise

Errors

n/a

Issue script & Debug output

n/a

Expected behavior

n/a

Environment Summary

Azure CLI 2.62.0

Additional context

No response

dbradish-microsoft avatar Jul 30 '24 20:07 dbradish-microsoft

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

yonzhan avatar Jul 30 '24 20:07 yonzhan

Here are some similar issues that might help you. Please check if they can solve your problem.

  • Azure/azure-cli#29522

github-actions[bot] avatar Jul 30 '24 20:07 github-actions[bot]

Thanks for the feedback! We are routing this to the appropriate team for follow-up. cc @shariq-mcs, @MSFTeegarden.

Fixed by: https://github.com/Azure/azure-cli/pull/29898, https://github.com/Azure/azure-cli-extensions/pull/8345

AllyW avatar Apr 03 '25 03:04 AllyW