To clarify the query regarding the status code documentation

[Vignesh-D-95]

Team - Can you please clarify whether the 502 response code should be documented in the Open API Spec?

502 Bad Gateway error is listed in the Zalando documentation but it is not clearly mentioned whether it has to be documented or not documented. Below is the link which has the details,

https://opensource.zalando.com/restful-api-guidelines/#status-code-502

[ePaul]

It looks like we missed to add either a document or do-not-document tag here (and same for 504).

Thanks for pointing us to it.

We just talked about it in the API guild meeting, and agree that all of 502, 503, 504 should have [use] + [do-not-document] tags.

I'll open a PR to fix it (and also the broken indentation).