Is is possible to customize admonition section for deprecated api?

[redjen8]

Is your feature request related to a problem?

I'm creating api doc pages for non native english speakers.
In the case of an api marked with deprecated, I have confirmed that the mdx file is created with the warning admonition automatically.
Can I request this by applying new custom markdownGenerators options?

Describe the solution you'd like

export function createDeprecationNotice({
  deprecated,
  description,
}: DeprecationNoticeProps) {
  return guard(deprecated, () =>
    createAdmonition({
      children:
        description && description.length > 0
          ? clean(description)
          : "This endpoint has been deprecated and may be replaced or removed in future versions of the API.",
    })
  );
}

I wish there was a good way to customize the automatically generated deprecation message (Please check below example)

Describe alternatives you've considered

Is there any way to customize createDeprecationNotice function by applying markdownGenerators option?

Additional context

[sserrata]

Hi @redjen8, you can definitely customize this using markdownGenerators but are you interested in customizing the description/message or the "⚠ DEPRECATED" title (or both)?

If you just want to change the description, you can use the x-deprecated-description extension.

Example:

  /pet/findByTags:
    get:
      tags:
        - pet
      summary: Finds Pets by tags
      description: >-
        Multiple tags can be provided with comma separated strings. Use tag1,
        tag2, tag3 for testing.
      operationId: findPetsByTags
      deprecated: true
      x-deprecated-description: "this is a test"
      parameters:
        - name: tags
          in: query
          description: Tags to filter by
          required: true
          style: form
          schema:
            type: array
            items:
              type: string
...

[redjen8]

@sserrata
Thank you for your response, I didn't know if I could change the description using x-deprecated-description.

By the way, it seems that the description content can only be changed by editing the document data directly.
Is there a way to modify content in the docusaurus-openapi-docs plug-in itself without adding extensions to every single deprecated marked api?