Azure / Azure/azure-cli-extensions

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

Open
#8,100 2 comments 0 reactions 0 assignees View on GitHub
bug Service Attention Similar-Issue
Dominant language
Python
Stars
454
Forks
1.7k
Avg merge
2d 19h
Merged PRs (30d)
64

Description

### 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](https://github.com/user-attachments/assets/5552ae5e-dd43-4376-b8fc-3c6c750707e2)

### Requested solution:
These values should be escaped with a backtick. Here's an example from [az webpubsub](https://learn.microsoft.com/en-us/cli/azure/webpubsub?view=azure-cli-latest#az-webpubsub-create-required-parameters).
![image](https://github.com/user-attachments/assets/806899f7-9eca-483e-a175-c486f003b7f4)

### Published reference guidelines
Guidelines for [Parameters used in examples](https://github.com/Azure/azure-cli/blob/dev/doc/reference_doc_guidelines.md#parameters-used-in-examples)

### Related GitHub issues:
This is the same issue as [these GitHub issues](https://github.com/Azure/azure-cli/issues?q=is%3Aissue+author%3Adbradish-microsoft+HTML+in%3Atitle+).

### List of HTML tag instances that need update:
|File name | Build error |
|-|-|
| latest/docs-ref-autogen/partnercenter/marketplace/offer/plan/technical-configuration/package.yml | HTML tag 'hashcode' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder. |

### Related command

az partnercenter

### Errors

n/a

### Issue script & Debug output

n/a

### Expected behavior

n/a

### Environment Summary

Azure CLI 2.62.0

### Additional context

_No response_

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.