Expanding RenderTargetSchema on the human-readable Server API docs either fails to render or causes page to hang

[jhobz]

Repro steps:

1. Navigate to https://ograf.ebu.io/v1/specification/open-api/docs/index.html
2. Expand RenderTargetSchema
3. Observe either a page hang or the element describes that the contents could not be rendered (page hang was more often the result in my experience)

[nytamin]

I can confirm there being an issue.
When opening RenderTargetSchema the browser eventually throws an error:

Resolver error
Maximum call stack size exceeded

I'm not sure what causes the issue, either there is some recursive reference within RenderTargetSchema (which is technically allowed and not an issue on its own) and/or an issue in how the Swagger-UI generates the docs.

[nytamin]

Notes from OGraf Meeting 2026-03-04:

It looks like this is an issue in the swagger docs, due to the recursive schemas in the GDD-json-schemas.
Having recursion is allowed in JSON-schemas, so we don't want to change the GDD-json-schemas themselves.

If anyone have an idea on how to fix the issue in the Swagger-UI, feel free to contribute a fix.