Couchbase incorporated Swagger into our documentation a few months ago. “Swagger” refers to an ecosystem of tools and other resources for managing REST APIs. Core to Swagger is the Swagger specification. (The group behind Swagger donated the spec to … more
My business card states my title as “Technology Evangelist”. I learn technology, use it in solutions to the point where I can teach it to others then I preach it. My audience is mostly people who probably think I’m a little crazy. When it comes to REST and API’s the answer I recommend now is using Swagger and its toolset to design, manage and document your valuable API’s. I scream every time I see Word/Excel/Email documents beings used to define API’s in large systems. Using 20th-century tools to manage modern 21st-century processes like API’s doesn’t scale and helps contribute to some of the failures I have seen.