What is a good tool for documenting Microservices?

1.	What is a good tool for documenting Microservices?
Answer» Swagger is a very good open-source tool for documenting APIs PROVIDED by microservices. It provides very easy to USE INTERACTIVE documentation. By the use of swagger annotation on REST endpoint, api documentation can be auto-generated and exposed over the web interface. An internal and external team can use web interface, to see the list of APIs and their inputs & error CODES. They can even invoke the endpoints directly from web interface to get the results. Swagger UI is a very powerful tool for your microservices consumers to help them understand the set of endpoints provided by a given microservice.

Answer»

Swagger is a very good open-source tool for documenting APIs PROVIDED by microservices. It provides very easy to USE INTERACTIVE documentation.

By the use of swagger annotation on REST endpoint, api documentation can be auto-generated and exposed over the web interface. An internal and external team can use web interface, to see the list of APIs and their inputs & error CODES. They can even invoke the endpoints directly from web interface to get the results.

Swagger UI is a very powerful tool for your microservices consumers to help them understand the set of endpoints provided by a given microservice.

Discussion

No Comment Found

Related InterviewSolutions

What are the use cases for JWT?
What are the tools and libraries available for testing microservices?
How OAuth2 Works?
How does JWT look like?
Why Basic Authentication is not suitable in the Microservices Context?
What is a good tool for documenting Microservices?
How will you implement caching for microservices?
What are best practices for microservices architecture?
Is it a good idea to share a common database across multiple microservices?
How will you ignore certain exceptions in Hystrix fallback execution?