My team is working on a web application using Micro Service Architecture and Angular + Spring MVC. We follow Agile development. For each story, we create few implementation and test tasks. Documenting REST API is the first task to be done in the story.We currently document it in Confluence so that developers and testers can work on implementation and test cases respectively. We are looking to generate REST API documentation with Swagger automatically using codegen. It looks like documenting in Confluence and generating with Swagger is redundant. However, swagger generates accurate documentation. What is the best way to document REST API before coding ? Are there any other tools ?
How to document REST API before coding
rest;documentation;api design;swagger