Provide a way to tell users that multiple JSDoc comments was created for the same endpoint

[daffaalex22]

Is your feature request related to a problem? Please describe. I got this issue multiple times when using this library. The first time was a couple years ago. And the last time was yesterday.

I defined the JSDoc Documentation on multiple places:

• Route definition
• Controller (place for handling request body, params, etc)

And then I try to create the Request Body & Response Body schema on the Controller. The schemas I defined inside the Controller are shown on the Swagger's schema definition list, but it doesn't link to the corresponding route.

This is because the library only detects the docs on the Route Definition. I haven't defined the types and schemas there.

So the issues are:

• There are multiple docs for the same endpoint, which I wasn't aware immediately
• The Schemas loaded on the Swagger, but it doesn't link to the correct Route (endpoint)

I got stuck on this issue for hours. AI don't even fix it immediatlely

Another possibility is that I am just not patient enough, or my AI prompt is not good enough.

Describe the solution you'd like

• There should be a way for this library to tell that there are multiple docs created for the same endpoint.
• That could perhaps be done through the terminal logs, or through swagger errors itself

Describe alternatives you've considered

• I am not sure

Additional context

• Not yet, perhaps I should create step by step to reproduce my issue