Question: Consistent and deterministic order in OAS

[g-stone7]

I am using the springdoc-openapi-gradle-plugin to export my api as OAS and generate clients/consumers from it for an angular application. It seems the generated OAS doesn't have a consistent order and on every generation there are a few changes in the git changelog only due to a changed order. From my observations it mainly affects the responses part of the oas per endpoint.

How to reproduce?

1. Generate oas
2. Add a new endpoint
3. Generate oas again

Expected
Diff should only contain changes added in step 2.

Actual
Diff contains changes added in step 2, but changes exist also in some untouched responses only because of a changed order

To clarify: It is not a real issue or bug, but having a deterministic oas generation would keep the diffs small and better understandable. Is there a config option maybe? If not, can this be added?

[bnasslahsen]

@g-stone7,

Use springdoc.writer-with-order-by-keys=false, which enables a deterministic/alphabetical ordering.