OpenAPI descriptor validation

Information about OpenAPI descriptor validation is displayed only at specific times.

  • Warnings are displayed in the OpenAPI descriptor file and in the Problems view.
  • The line that the warning is displayed on does not necessarily indicate where the problem is in the OpenAPI descriptor file.
  • Warnings do not prevent you from adding new elements to the OpenAPI descriptor. The warnings might include problems such as missing required elements or the presence of non-swagger elements.
  • If you use the menu item to add new elements to the OpenAPI descriptor and non-swagger elements are present, the non-swagger elements are removed when you click Finish with any of the New > Element wizards.
  • If you use the menu item to add new elements to the OpenAPI descriptor file, the file is deserialized into a Swagger Model, which is reordered in a standard way. For example, operations are displayed in the same order.