I am a tester who has heard the commentary among devs that API is self documenting.
And they leave it at that, as though "no need to discuss anymore" where i feel like the truth is actually that there is a dependency on the front end that the devs actually have to include documentary. i.e. - Implementation Notes could include much more documentation (words) instead of the two word reminder to the dev. - Notes about required fields or syntax in the fields that are passed in. (often i may be testing an endpoint only to find out syntax needs to be "X" or certain fields are required. Point being "to say swagger is self documenting" is a little misleading and needs a qualifier. *provided the documentation is included in code. Am i right or wrong? or somewhere in between. thank you (first time here) -- You received this message because you are subscribed to the Google Groups "Swagger" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. For more options, visit https://groups.google.com/d/optout.
