Option to split files only where OpenAPI expect references? about create-openapi-repo HOT 4 CLOSED

Nope. We decided to use Stoplight Studio. Working with files in Studio wasn't problematic so I even kind of forgot why I wanted to use this in the first place. I was researching tools at the time and hadn't quite had the feel for the flow of how the spec will be written and used on daily basis. Now I think we can work without this.

from create-openapi-repo.

Were you able to find any way to do it? as splitting is good and all but I can't use Stoplight Studio there

from create-openapi-repo.

Here I mean referring to markdown description files via $ref and those special filenames for paths.

The special filenames for paths are just a pattern for convenience. In the previous version of our tool those were used for spcial purposes but now everything is using just $refs. By default the tool splits into spec-compliant OpenAPI (OpenAPI officially supports $ref on path item items.) except for the $ref for info.description I believe.

But you can easily revert info.description manually after you definition is split. We may add some flag though.

from create-openapi-repo.

This is done (in a separate Redocly CLI split command): https://redocly.com/docs/cli/commands/split/

from create-openapi-repo.