How to share Swagger documentation

Question

I recently started using Swagger for my documentation but there are few things that are still unclear to me. I created my YAML document and now I would like to be able to share my documentation in a .pdf or HTML/Javascript page with the rest of my team. I can't use SwaggerHub because they don't have private repositories and Swagger Editor doesn't appear to allow to share the panel on the right.

Just to be clear, I would like to be able to get something like:

What am I missing?

Answer 1

I'm biased as I work on swaggerhub, but that's what the project is for:

https://swaggerhub.com

From there, you can push your swagger specs automatically to github and also make other users collaborators on the API (or just read-only).