[Question] How do relative paths work

[jan-ldwg]

Given the following OpenAPI schema

and the folder structure

essentials-openapi fails to resolve the relative path for the external JSON schema. It tries to resolve it from Users/<myusername> (I'm on macos), not from the folder of the Open API schema site_manager_docs/api.

An absolute path works just fine. Other tools like redocly-cli correctly resolve the relative path.

Is this the expected behavior? This makes it really hard to specify paths that work on different systems like on the actions runners of my CI pipeline.

Bundling first with redocly-cli is a workaround, but that tools has issues handling the $schema property in JSON schemas so would like to avoid it.