Documenting your APIs behavior / contract on a confluence page enough for building common understanding?
In my experience, these pages often remain as static pages. The code keeps changing and the documentation does not.
I prefer using swagger to document workings of the API and use that as a reference.
This way you have a living document and no need to keep updating a static page.
Oh, and just to add, functional & contract tests are going to ensure if your building your services properly.
#RedefiningSoftwareQuality #TestAutomation #APIs #Swagger