François COLIN (Odigo)

## What happened? Some IDE (as Jetbrains ones) allow usage of special comments to create custom foldable regions in code. This supports two common syntaxes (see [this article](https://blog.jetbrains.com/idea/2012/03/custom-code-folding-regions-in-intellij-idea-111/)): - `//region...

Lots of $ref to other files leads to random errors due to unprocessed $ref targets

1

[OpenAPI 3+ allows usage `$ref:` with references to other files](https://swagger.io/docs/specification/using-ref/); this allows to split the OpenAPI Description (OAD) in several files. Main usage is: a root `openapi.yaml` files with objects...