I am trying to develop application in cloud native way. I am trying have API first design of my application.
Which API documentation tool should I use? which one is more suitable for API first Contracts? rather which one of it suitable where?
I am trying to develop application in cloud native way. I am trying have API first design of my application.
Which API documentation tool should I use? which one is more suitable for API first Contracts? rather which one of it suitable where?
Copyright © 2021 Jogjafile Inc.
I'd say both formats are suitable for API first approach, so it's a matter of taste (markdown vs yaml/json based) or tool limitation.
You can read a brief summary at https://help.apiary.io/api_101/choosing-format/.