Swashbuckle.webapi: Support Redoc as an alternative to Swagger UI

Created on 25 Nov 2016  路  4Comments  路  Source: domaindrivendev/Swashbuckle.WebApi

Redoc is an alternative to Swagger UI that offers branded, 3 column layout and code samples:

It would be nice to be able to easily use this with Swashbuckle in a similar manner to how we can use Swagger UI.

Most helpful comment

@RomanGotsiy
Redoc has a nice/clean interface, but I do not see where we can make sample calls...
It looks Redoc is just for documentation not for interacting with the API, that might be a major disadvantage!

All 4 comments

Not too much native, but I put redoc html in my project folder (virtual directory for hosting) and that's it

```







ReDoc






And bower.json:
```{
  "name": "api_docs",
  "authors": ["Georgy Grigoryev"],
  "description": "ReDoc documentation by swagger",
  "main": "redoc.html",
  "private": true,
  "dependencies": {
    "redoc": "^1.6.2"
  }
}

ReDoc uses the tags at the API level and the method to produce the output of the left hand side bar, as long as the tags are the same the methods get grouped. Did you guys work out how to get swashbuckle to output tags in the right spots?

Hey,
ReDoc author here.

@domaindrivendev, I would be happy to help you guys to integrate ReDoc into Swashbuckle as an alternative to Swagger UI.
Let me know if you need any help from my side!

@RomanGotsiy
Redoc has a nice/clean interface, but I do not see where we can make sample calls...
It looks Redoc is just for documentation not for interacting with the API, that might be a major disadvantage!

Was this page helpful?
0 / 5 - 0 ratings

Related issues

DotNetRockStar picture DotNetRockStar  路  3Comments

niemyjski picture niemyjski  路  3Comments

kuttiram picture kuttiram  路  5Comments

thj-dk picture thj-dk  路  5Comments

qwertykeith picture qwertykeith  路  5Comments