The Wayback Machine - https://web.archive.org/web/20200711045221/https://github.com/topics/swagger-spec
Skip to content
#

swagger-spec

Here are 31 public repositories matching this topic...

georg-schwarz
georg-schwarz commented Apr 8, 2020

Hi together,

I just started using swagger-jsdoc in my nodejs project using Typescript. It was kind of hard to figure out how to use it due to the transpilation process involved.

There are a few workarounds necessary to make it work:

  • apis [...] has to point to files in the /dist directory due to the transpilation process
  • Annotations (in the comments) to model classes are lost in the t
djensen47
djensen47 commented Feb 10, 2020

Thanks for the great project! I just wanted to suggest adding some details to the documentation regarding usage as well as dependencies.

It's true that all of these things are available in the code via tests but it's not super intuitive where to find them. As I write this I know that I found the usage; it's fairly easy but since I didn't commit it to memory I'll have to dig through the tests ag

SirTomme
SirTomme commented Mar 8, 2018

Besides just checking if a preprocessor variable has a given value (@rest\if name value) it would be very helpful to have its value inserted somewhere inside the documentation.
For example instead of incrementing the API version manually as in
// @rest\version 0.9.14

I would like to have it changed automatically like:
// @rest\version {myversion}
`$SwaggerGen->define('myversio

Introduction and Example for OpenAPI specification & Swagger Open Source Tools, including swagger-editor, swagger-codegen and swagger-ui. Auto generation example for client SDKs, server code, asciidoctor and html documents.

  • Updated Jun 19, 2018
  • Java

Improve this page

Add a description, image, and links to the swagger-spec topic page so that developers can more easily learn about it.

Curate this topic

Add this topic to your repo

To associate your repository with the swagger-spec topic, visit your repo's landing page and select "manage topics."

Learn more

You can’t perform that action at this time.