Adding a new optional property to the request/response body is considered backward incompatible.

Hi,
Why adding a new optional property (with default value) is considered to be an incompatible change?

• V1 client sends a request without a new field - then the default value will be used by the V2 server - [OK]
• V1 client receives the response from the V2 server with a new field - it will simply be ignored by the V1 client - [OK]

I really do not see why the diff tool reports it as an incompatible change?

まず、2つの最小限の OpenAPI 仕様を使って互換性レポートを再現します。1つは元のリクエスト/レスポンスボディを含むもの、もう1つはデフォルト値を持つオプショナルなプロパティを追加したものです。diff ツールがそのリクエストとレスポンスの変更をどのように分類するかを追跡し、その結果を issue に記載された想定される後方互換性の動作と照合して確認します。