Documentation feature requests

[hongaar]

We recently switched from Swagger UI to Postman documentation and it's a real lifesaver to have API testing and docs integrated! Here are some suggestions which would make the documentation even better:

• Optionally integrate example responses (which are already saved in collection request examples) (I see now that https://docs.api.getpostman.com/ already has this, but can't seem to get it to work.)
• Ability to re-order examples in the Postman app, and reflect in documentation
• Custom CSS (I see it's already on the roadmap: https://trello.com/c/F8NLGock/13-custom-css-for-docs)
• Ability to enable/disable languages for code samples (i.e. we want to only include cURL code examples and link to SDKs for other languages)
• Include the Authorization header when Bearer Token is selected as the Auth method for a request
• Ability to style the variables (i.e. {{token}}) by wrapping those in i.e. a <span class="variable"/> element in request URI, headers, params, code examples, etc.

[prashantagarwal]

@hongaar Thanks for suggesting these. We will surely have a look a them