Nowadays, developers are constantly working with APIs and not all of them have good documentation. This blog post shows how to create complete and updated documentation for APIs in Spring projects using Spring REST Docs.

What is a microservices architecture? The microservices architecture pattern consists in functionally decompose a project into a set of collaborative services. Each service will take care of a concrete functionality, a concrete domain. Services will be developed independently, avoiding coupling between them. If needed, services can communicate through an exposed API, using HTTP/REST calls, for instance. Using this approach, multiple developers can work on the same project in a more independent way. Each service will have its own database (schema or set of tables) which will not be accessed by…