From 0a39019a4d792399760f63708271258855a6e1a7 Mon Sep 17 00:00:00 2001 From: Iury Lenon Date: Mon, 23 Feb 2026 21:15:09 +0000 Subject: [PATCH] Update docs/features/software-catalog/configuration.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Signed-off-by: Iury Lenon --- docs/features/software-catalog/configuration.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/features/software-catalog/configuration.md b/docs/features/software-catalog/configuration.md index 88a12ceba6..d9cba22582 100644 --- a/docs/features/software-catalog/configuration.md +++ b/docs/features/software-catalog/configuration.md @@ -367,9 +367,9 @@ Now install your module. backend.add(eventsModuleCatalogErrors); ``` -## OpenAPI and $ref Support +## OpenAPI and AsyncAPI Placeholder Support -If you are using OpenAPI specifications that are split into multiple files using `$ref`, standard processing might not resolve them correctly. To fix this, you should install the **OpenAPI Catalog Backend Module**. This module helps resolve `$ref` pointers in your YAML documents, bundling them into a single specification for the catalog. +The **OpenAPI Catalog Backend Module** registers a JSON Schema placeholder resolver for the `openapi` (and `asyncapi`) placeholder keys. This enables you to use `$openapi` and `$asyncapi` references in your catalog entities, while having all underlying `$ref` pointers resolved and bundled as part of the schema processing. ### Installation