Nashville, TN
September 24 - 26, 2018
Click Here For Information & Registration
Wednesday, September 26 • 2:30pm - 2:50pm
Generating Product-Quality SDKs and API Reference Documentation - Michael Kistler, IBM

Sign up or log in to save this to your schedule, view media, leave feedback and see who's attending!

Feedback form is now closed.
The Watson Cloud team at IBM have built a system to generate SDKs and API Reference documentation from OpenAPI descriptions of the IBM Watson Cloud services. They developed a methodology that includes standards for API design and description, based on OpenAPI but with extensions to capture special API or SDK features, along with a validator that ensures compliance to these standards. They built tools using the Swagger Codegen framework that generate product-quality SDKs that incorporate best practices for API design, code structure, documentation, and extensibility in each target language, and API reference documentation focused around these SDKs. Their methodology and tools enable them to achieve this result for less internal effort than would be possible with existing tools. This talk will describe their system in hopes that it will help others generate usable SDKs and documentation.

avatar for Mike Kistler

Mike Kistler

Senior Technical Staff Member, IBM Corp
Mike Kistler is a Senior Technical Staff Member in the IBM Cloud Division in Austin, TX. He joined IBM in 1982 and has held technical and management positions in various product groups, IBM Research, and now in the IBM Cloud Division. He received his BA in Computer Science from Susquehanna... Read More →

Wednesday September 26, 2018 2:30pm - 2:50pm CDT
Davidson Ballroom B 1/2