Unable to view API Level Description ,Resource Level Summary & Description for API Documentation published on Developer Portal through Swagger 2

Hi

We are creating Model and uploading Swagger 2 JSON on Developer Portal to view our API Documentation

We are facing few issues where we are unable to see the API Level Documentation.

Also Resource Level Summary and Description are not coming correctly from Swagger.

Attaching the Swagger and actual Java class and the screenshots of Developer Portal highlighting the issues in RED.

Below the name of the API on Method Listing page, there should be the description of API, this we have given (check java class attached) as part of

@SwaggerDefinition @Tag( name = "symbolic time period", description = "this is detailed description for this resource" )

Also as part of @ApiOperation we have provided "value" and "notes" attributes (check java class attached) which should come as part of summary of the resource on Method Listing Page and description on the actual Method page which is the next page when we click on any resource.

Can you please help in displaying the API Documentation correctly as per our requirement above.

Thanks

dev-portal-api-doc-issues.zip

1 0 641
0 REPLIES 0