Keep every OpenAPI component (schema, parameter, response, ...) in its own YAML, JSON or Ruby file, share components between documents, and assemble the hash rswag's `config.openapi_specs` (or any other OpenAPI consumer) expects. Ruby component files can reference application constants, so enums and limits stay defined once. Ships a linter for dangling $ref pointers and unreferenced components.