paulononato/backstage
1
0
Fork 0
Code Issues Pull Requests Actions 28 Packages Projects Releases Wiki Activity

Update docs/features/software-catalog/configuration.md

Browse Source 
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Iury Lenon <iuryalves.uk@gmail.com>
This commit is contained in:
Iury Lenon
2026-02-23 21:15:09 +00:00
committed by GitHub
parent 1a8a464d1d
commit 0a39019a4d
1 changed files with 2 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/features/software-catalog/configuration.md
+2 -2
View File
@@ -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