{eventgrid} HTML tags are rendering as empty parameter values in reference docs

[dbradish-microsoft]

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:

Requested solution:

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

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/eventgrid/namespace/ca-certificate.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/eventgrid/namespace/ca-certificate.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/eventgrid/namespace/client.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/eventgrid/namespace/client.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/eventgrid/namespace/client-group.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/eventgrid/namespace/client-group.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/eventgrid/namespace/permission-binding.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/eventgrid/namespace/permission-binding.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/eventgrid/namespace/topic.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/eventgrid/namespace/topic.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/eventgrid/namespace/topic/event-subscription.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/eventgrid/namespace/topic/event-subscription.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/eventgrid/namespace/topic-space.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/eventgrid/namespace/topic-space.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/eventgrid/partner/configuration.yml	HTML tag 'name' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
latest/docs-ref-autogen/eventgrid/partner/configuration.yml	HTML tag 'id' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
latest/docs-ref-autogen/eventgrid/partner/configuration.yml	HTML tag 'timestamp' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
latest/docs-ref-autogen/eventgrid/partner/namespace/channel.yml	HTML tag 'description' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
latest/docs-ref-autogen/eventgrid/partner/namespace/channel.yml	HTML tag 'url' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
latest/docs-ref-autogen/eventgrid/partner/namespace/channel.yml	HTML tag 'url' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
latest/docs-ref-autogen/eventgrid/partner/namespace/channel.yml	HTML tag 'description' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
latest/docs-ref-autogen/eventgrid/partner/namespace/channel.yml	HTML tag 'url' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
latest/docs-ref-autogen/eventgrid/partner/namespace/channel.yml	HTML tag 'url' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.

Related command

az eventgrid

Errors

n/a

Issue script & Debug output

n/a

Expected behavior

n/a

Environment Summary

This GitHub issue was created at the time of Azure CLI 2.62.0

Additional context

No response

[yonzhan]

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

[github-actions[bot]]

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

• 29523

• 29521

• 29528

• 29525

• 29526

[microsoft-github-policy-service[bot]]

Thanks for the feedback! We are routing this to the appropriate team for follow-up. cc @jfggdl.