swagger-codegen icon indicating copy to clipboard operation
swagger-codegen copied to clipboard

HTML2 output contains errors and does not match API code or documentation

Open katiepet opened this issue 1 year ago • 2 comments

Description

The HTML2 doc generated from our APIs contains the following errors:

  1. The capitalization is incorrect in the HTML2 output and does not match the API.
  2. The calls have been reorganized in the HTML2 and do not match the order shown in the original code.
  3. Some of the call names are different, and incorrect, in the HTML2 version. For example, some of the GET calls have been changed to ADD.

image image

This is a problem because we cannot generate accurate documentation from our APIs.

Swagger-codegen version
The current version in SwaggerHub cloud.

katiepet avatar Dec 18 '23 16:12 katiepet

Hello @katiepet , is it possible you share an example of the OAS document to reproduce the issue?

HugoMario avatar Dec 22 '23 17:12 HugoMario

@HugoMario I can't share that due to confidentiality concerns. But the screen captures above show the issues I'm asking about.

katiepet avatar Jan 02 '24 19:01 katiepet