-
Notifications
You must be signed in to change notification settings - Fork 3.1k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
{doc} Fix disallowed html tags #30424
Conversation
️✔️AzureCLI-FullTest
|
Hi @Jing-song, |
️✔️AzureCLI-BreakingChangeTest
|
Thank you for your contribution! We will review the pull request and get back to you soon. |
/azp run |
Azure Pipelines successfully started running 3 pipeline(s). |
src/azure-cli/azure/cli/command_modules/containerapp/_params.py
Outdated
Show resolved
Hide resolved
src/azure-cli/azure/cli/command_modules/containerapp/_params.py
Outdated
Show resolved
Hide resolved
src/azure-cli/azure/cli/command_modules/containerapp/_params.py
Outdated
Show resolved
Hide resolved
src/azure-cli/azure/cli/command_modules/containerapp/_params.py
Outdated
Show resolved
Hide resolved
src/azure-cli/azure/cli/command_modules/containerapp/_params.py
Outdated
Show resolved
Hide resolved
Co-authored-by: AllyW <AllyW@users.noreply.github.com>
@@ -47,7 +47,7 @@ def _build_arguments_schema(cls, *args, **kwargs): | |||
) | |||
_args_schema.search_service_name = AAZStrArg( | |||
options=["-n", "--name", "--search-service-name"], | |||
help="The name of the Azure Cognitive Search service to create or update. Search service names must only contain lowercase letters, digits or dashes, cannot use dash as the first two or last one characters, cannot contain consecutive dashes, and must be between 2 and 60 characters in length. Search service names must be globally unique since they are part of the service URI (https://<name>.search.windows.net). You cannot change the service name after the service is created.", | |||
help="The name of the Azure Cognitive Search service to create or update. Search service names must only contain lowercase letters, digits or dashes, cannot use dash as the first two or last one characters, cannot contain consecutive dashes, and must be between 2 and 60 characters in length. Search service names must be globally unique since they are part of the service URI (`https://<name>.search.windows.net`). You cannot change the service name after the service is created.", |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Please fix it in aaz model as well
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
search service didn't upload their original aaz models into cli repo.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We should contact the search service to provide the aaz model and fix their models.
...li/azure/cli/command_modules/network/aaz/latest/network/application_gateway/probe/_create.py
Show resolved
Hide resolved
@@ -55,7 +55,7 @@ def _build_arguments_schema(cls, *args, **kwargs): | |||
) | |||
_args_schema.filter = AAZStrArg( | |||
options=["--filter"], | |||
help="Specify $filter='Type eq <type>' to filter on user type property", | |||
help="Specify `$filter='Type eq <type>'` to filter on user type property", |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Is this change synced with aaz repo?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yes, aaz model has been updated in this pr: Azure/aaz#655
This PR should be backported to LTS, as |
Related command
Description
Content inside
<>
are interpreted as HTML tags by the reference doc generation pipeline, and doc page refuse to render those illegal html tags (please check rule detail here), which will cause our cli doc page info rendering missing.In current cli help message,
<>
is widely used as placeholder tag, cmd parameter demonstrations etc.Therefore, we continued on mitigating the disallowed html tag issues in our documentation by applying the following methods:
`docker logout <registry url>`
<>
to{}
, if option 1 is not applicable, like<key>=<value>
to{key}={value}
This pr is a continued effort to fix disallowed html tags in documentation, with following previous prs:
#27752
#29898
Testing Guide
History Notes
[Component Name 1] BREAKING CHANGE:
az command a
: Make some customer-facing breaking change[Component Name 2]
az command b
: Add some customer-facing featureThis checklist is used to make sure that common guidelines for a pull request are followed.
The PR title and description has followed the guideline in Submitting Pull Requests.
I adhere to the Command Guidelines.
I adhere to the Error Handling Guidelines.