OpenAPI Overlay는 대상 문서의 노드를 선택하고 순서대로 갱신·삭제·복사할 수 있는 별도 문서입니다. 원본 설명은 유지하면서 팀별 설명, 태그, 배포 환경에 맞는 문서 보강을 적용할 수 있습니다. 액션은 앞선 액션의 결과에 이어 적용됩니다.
데모는 원본 GET /orders 설명에 오버레이를 켰을 때 audience 태그와 설명이 합쳐지는 모습을 보여줍니다. 변환 결과도 검증해야 하며, 원본과 오버레이의 책임을 명확히 구분해야 합니다.
언제 쓰나
외부에서 받은 명세나 공용 명세를 유지하면서 팀별 설명을 덧붙일 때 씁니다.