Servers/Base URL not being overridden at path or operation level

[jeffski]

Describe the bug
According to the docs here: https://swagger.io/docs/specification/api-host-and-base-path/#overriding, it should be possible to override the global servers setting at the path or operation level. As far as I can tell the global URL set under servers is always used and can not be overridden in the code examples, or mentioned anywhere in the generated markdown.

As an example if I set global servers like this:

servers:
  - url: "https://api.domain.com/"

then, override it like this in a path:

paths:
  books/{id}
    get:
      servers:
        - url: https://legacy.domain.com/

Then the code examples all still use the global servers url, like:

curl -X GET https://api.domain.com/books/{id} \

Expected behavior
I would expect to see the code examples use the overridden value:

curl -X GET https://legacy.domain.com/books/{id} \

Also somewhere in the body of the documentation it should show the url/server for the request.

Versions:

• Node.js v12.18.3

[MikeRalphson]

Thanks for the report. Confirmed.