Request: openapi.yaml - Publish a pre-bundled YAML file

[j-westover]

The current openapi.yaml uses external $refs to hundreds of files at http://redfish.dmtf.org/schemas/v1/*.yaml. Every consumer must:

1. Fetch hundreds of external schema files over HTTP during bundling
2. Handle transitive ref chains (wrapper files → versioned files → sibling schemas)
3. Work around bundler differences in how cross-file local $refs are resolved

Different bundling tools produce different results. This forces consumers to implement workarounds for their specific toolchain.

Proposal

Publish an openapi_bundled.yaml (or .json) alongside openapi.yaml in the Redfish-Publications repository with all external $refs resolved to internal #/components/schemas/ references.

This is a one-time addition to the build pipeline — likely a single redocly bundle command or equivalent — and would:

• Eliminate HTTP fetching during consumer builds
• Remove all bundler-specific edge cases
• Provide a single canonical bundled representation
• Make the spec immediately usable by any OpenAPI tool without preprocessing

[mraineri]

This is definitely a good improvement we can investigate adding. We would need to discuss this at the main forum for wider socialization.