{postgres} HTML tag isn't allowed in example syntax

[dbradish-microsoft]

Describe the bug

The source code for postgres server is using HTML tags for examples.

There are eight instances:
https://github.com/MicrosoftDocs/azure-docs-cli/blob/main/latest/docs-ref-autogen/postgres/flexible-server.yml

1. Line 986: HTML tag 'indexToRemove' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
2. Line 993: HTML tag 'value' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.

https://github.com/MicrosoftDocs/azure-docs-cli/blob/main/latest/docs-ref-autogen/postgres/server.yml

1. Line 79: HTML tag 'SingleIP' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
2. Line 79: HTML tag 'StartIP-DestinationIP' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
3. Line 417: HTML tag 'SingleIP' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
4. Line 417: HTML tag 'StartIP-DestinationIP' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
5. Line 421: HTML tag 'indexToRemove' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
6. Line 428: HTML tag 'value' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.

All eight instances render as blank in our autogenerated reference content. Modify these instances to use some other character like a backtick or escape character.

Contributor's Guide guideance:
https://review.learn.microsoft.com/en-us/help/platform/validation-ref/disallowed-html-tag?branch=main

Related command

az postgres flexible-server update --remove
az postgres flexible-server update --set

az postgres server create --public --public-network-access

az postgres server update --public --public-network-access
az postgres server update --public --remove
az postgres server update --public --set

Errors

MicrosoftDocs/azure-docs-cli warning:

Issue script & Debug output

See "Describe the bug" section above.

Expected behavior

See "Describe the bug" section above.

Environment Summary

See "Describe the bug" section above.

Additional context

No response

[yonzhan]

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

[microsoft-github-policy-service]

Thank you for your feedback. This has been routed to the support team for assistance.

[ghost]

Thanks for the feedback! We are routing this to the appropriate team for follow-up. cc @sunilagarwal, @lfittl-msft, @sr-msft, @niklarin.

Issue Details

---

Describe the bug

The source code for postgres server is using HTML tags for examples.

There are eight instances:
https://github.com/MicrosoftDocs/azure-docs-cli/blob/main/latest/docs-ref-autogen/postgres/flexible-server.yml

1. Line 986: HTML tag 'indexToRemove' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
2. Line 993: HTML tag 'value' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.

https://github.com/MicrosoftDocs/azure-docs-cli/blob/main/latest/docs-ref-autogen/postgres/server.yml

1. Line 79: HTML tag 'SingleIP' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
2. Line 79: HTML tag 'StartIP-DestinationIP' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
3. Line 417: HTML tag 'SingleIP' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
4. Line 417: HTML tag 'StartIP-DestinationIP' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
5. Line 421: HTML tag 'indexToRemove' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.
6. Line 428: HTML tag 'value' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.

All eight instances render as blank in our autogenerated reference content. Modify these instances to use some other character like a backtick or escape character.

Contributor's Guide guideance:
https://review.learn.microsoft.com/en-us/help/platform/validation-ref/disallowed-html-tag?branch=main

Related command

az postgres flexible-server update --remove
az postgres flexible-server update --set

az postgres server create --public --public-network-access

az postgres server update --public --public-network-access
az postgres server update --public --remove
az postgres server update --public --set

Errors

MicrosoftDocs/azure-docs-cli warning:

Issue script & Debug output

See "Describe the bug" section above.

Expected behavior

See "Describe the bug" section above.

Environment Summary

See "Describe the bug" section above.

Additional context

No response

Author:	dbradish-microsoft
Assignees:	-
Labels:	bug, Service Attention, PostgreSQL, Auto-Assign
Milestone:	-

[navba-MSFT]

Since this is non-customer reported, Adding Service team to look into this.

[dbradish-microsoft]

@yonzhan, do you know if this issue made it to anyone's backlog to get fixed?

[jiasli]

For

• az postgres flexible-server update --remove
• az postgres flexible-server update --set
• az postgres server update --public --remove
• az postgres server update --public --set

This issue is a duplicate of #27054

[dbradish-microsoft]

@jiasli, There are six GitHub issues for HTML tags -- one for each reference group.

[jiasli]

@dbradish-microsoft, thanks for the kind reminder. I am using #27054 as the main tracking issue.

[nachoalonsoportillo]

@yonzhan it seems this one was addressed with #27752. Please, proceed with closing it. Thanks!

[nachoalonsoportillo]

@yonzhan Please, close this one. Thanks!