概要
複数ファイルに分けた OpenAPI 記述を、ルートから $ref を辿って単一ファイルにまとめること。
多くの生成・ドキュメントツールはマルチファイルを想定しないため、配布前の定番処理になる。
通常は外部参照を文書内参照へ寄せ、--dereferenced では $ref 自体を解消して展開する。
複数の独立した API 記述を足し合わせる join とは目的が異なり、OpenAPI split と対になる。
複数ファイルに分けた OpenAPI 記述を、ルートから $ref を辿って単一ファイルにまとめること。
多くの生成・ドキュメントツールはマルチファイルを想定しないため、配布前の定番処理になる。
通常は外部参照を文書内参照へ寄せ、--dereferenced では $ref 自体を解消して展開する。
複数の独立した API 記述を足し合わせる join とは目的が異なり、OpenAPI split と対になる。